从NOT_A_JPEG到PARSING_ERRORnode-exif三类错误码的完整处理方案【免费下载链接】node-exifA node.js library to extract Exif metadata from images.项目地址: https://gitcode.com/gh_mirrors/no/node-exifnode-exif 是一个 Node.js 库用于从 JPEG 图片中提取 Exif 元数据相机型号、GPS 坐标、拍摄时间等。它解析失败时不会抛出裸异常而是通过回调返回带error.code的错误对象——NOT_A_JPEG、NO_EXIF_SEGMENT、PARSING_ERROR三个错误码各有不同的业务含义。分不清这三者你的图片上传服务要么误杀正常图片要么静默吞掉异常。本文带你一次搞懂。三类错误码速查表三个错误码全部定义在 lib/exif/ExifImage.js 的processImage方法中触发位置和含义如下错误码触发位置含义图片本身有问题吗NOT_A_JPEGlib/exif/ExifImage.js第 171-176 行文件头不是0xFFD8根本不是 JPEG❌ 格式不对NO_EXIF_SEGMENT第 210-214 行是合法 JPEG但没有 APP1Exif段✅ 正常情况PARSING_ERROR第 191-199 行有 Exif 段但内容损坏或结构非法⚠️ 数据损坏三个错误对象都附带error.source属性值为Buffer或File: 路径方便你在日志里定位是哪张图出了问题。NOT_A_JPEG先拦截别浪费解析库在解析第一行就检查 JPEG 文件头0xFFD8第 171 行。PNG、GIF、WebP 或文本文件传进来都会命中此码错误信息为The given image is not a JPEG and thus unsupported right now.处理建议这属于用户输入错误应直接拒绝并提示仅支持 JPEG 格式无需进入后续校验如果业务需要支持 PNG 等其他格式应在调用 node-exif 之前自行做格式分流而不是放宽这个检查NO_EXIF_SEGMENT最常见的假错误很多开发者把它当异常处理其实它是最正常的路径一张 JPEG 完全可以不含任何 Exif 段。库遍历完所有 JPEG 段都没找到0xFFE1APP1段后就会返回此码第 210 行No Exif segment found in the given image.处理建议不要记录为错误日志更不要向用户报错把它视为图片合法、元数据为空的正常返回返回空对象或跳过即可经验上手机直拍照片、截图、屏幕导出的图片很容易没有 Exif 段这在生产环境中占比往往超过 30%PARSING_ERRORExif段损坏或结构非法这是唯一真正代表数据异常的错误码。库找到 APP1 段后进入extractExifData第 217 行起任何一步结构校验失败都会被包装成PARSING_ERROR。常见的校验失败点Exif 头缺失段内前 6 字节不是Exif\0\0第 227-229 行TIFF 字节序非法既不是II小端也不是MM大端第 233-241 行TIFF magic number 错误期望0x002A但实际值不符第 246-249 行触发场景包括手工拼接/裁剪损坏的 JPEG、被不正规工具清洗过元数据的图片、上传中断导致的截断文件等。项目自带的测试样张如test/evil1.jpg就是为验证解析健壮性而准备的边界样本。处理建议记录告警日志而非错误带上error.source和error.message便于事后分析坏图来源对用户上传场景可降级为元数据缺失处理不要因此拒绝图片——图片像素本身可能完全正常排查困难时可设置环境变量DEBUGexif开启库内置调试日志依赖debug包它会打印解析中断的 offset 和原始错误推荐的统一错误处理骨架回调签名为callback(error, data, source)用error.code做三分支判断即可覆盖全部场景var ExifImage require(exif).ExifImage; new ExifImage({ image: photo.jpg }, function (error, exifData) { if (error) { switch (error.code) { case NOT_A_JPEG: return rejectFormat(error); // 拒绝不是JPEG case NO_EXIF_SEGMENT: return finish(null); // 正常无元数据 case PARSING_ERROR: warn(Exif损坏, error.source, error.message); return finish(null); // 降级继续处理图片 default: return handleError(error); // 其他异常如文件读取失败 } } finish(exifData); });注意文件不存在、传入既非路径也非 Buffer 等错误不带code属性所以default分支兜底不可少。完整 API 用法见 README.md核心解析逻辑在 lib/exif/ExifImage.js入口模块为 index.js。实战检查清单✅ 用error.code分支处理而不是只看error.message文本✅NO_EXIF_SEGMENT走正常流程不打错误日志✅PARSING_ERROR降级处理 告警不拒绝合法图片✅ 日志中带上error.source定位问题图片✅ 调试时打开DEBUGexif查看解析中断位置✅ 记得兜底处理无code的异常文件读取失败等把三个错误码对应到拒绝 / 正常 / 降级三条路径你的 Exif 提取服务就能稳稳接住所有图片了。【免费下载链接】node-exifA node.js library to extract Exif metadata from images.项目地址: https://gitcode.com/gh_mirrors/no/node-exif创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 从NOT_A_JPEG到PARSING_ERROR：node-exif三类错误码的完整处理方案
从NOT_A_JPEG到PARSING_ERRORnode-exif三类错误码的完整处理方案【免费下载链接】node-exifA node.js library to extract Exif metadata from images.项目地址: https://gitcode.com/gh_mirrors/no/node-exifnode-exif 是一个 Node.js 库用于从 JPEG 图片中提取 Exif 元数据相机型号、GPS 坐标、拍摄时间等。它解析失败时不会抛出裸异常而是通过回调返回带error.code的错误对象——NOT_A_JPEG、NO_EXIF_SEGMENT、PARSING_ERROR三个错误码各有不同的业务含义。分不清这三者你的图片上传服务要么误杀正常图片要么静默吞掉异常。本文带你一次搞懂。三类错误码速查表三个错误码全部定义在 lib/exif/ExifImage.js 的processImage方法中触发位置和含义如下错误码触发位置含义图片本身有问题吗NOT_A_JPEGlib/exif/ExifImage.js第 171-176 行文件头不是0xFFD8根本不是 JPEG❌ 格式不对NO_EXIF_SEGMENT第 210-214 行是合法 JPEG但没有 APP1Exif段✅ 正常情况PARSING_ERROR第 191-199 行有 Exif 段但内容损坏或结构非法⚠️ 数据损坏三个错误对象都附带error.source属性值为Buffer或File: 路径方便你在日志里定位是哪张图出了问题。NOT_A_JPEG先拦截别浪费解析库在解析第一行就检查 JPEG 文件头0xFFD8第 171 行。PNG、GIF、WebP 或文本文件传进来都会命中此码错误信息为The given image is not a JPEG and thus unsupported right now.处理建议这属于用户输入错误应直接拒绝并提示仅支持 JPEG 格式无需进入后续校验如果业务需要支持 PNG 等其他格式应在调用 node-exif 之前自行做格式分流而不是放宽这个检查NO_EXIF_SEGMENT最常见的假错误很多开发者把它当异常处理其实它是最正常的路径一张 JPEG 完全可以不含任何 Exif 段。库遍历完所有 JPEG 段都没找到0xFFE1APP1段后就会返回此码第 210 行No Exif segment found in the given image.处理建议不要记录为错误日志更不要向用户报错把它视为图片合法、元数据为空的正常返回返回空对象或跳过即可经验上手机直拍照片、截图、屏幕导出的图片很容易没有 Exif 段这在生产环境中占比往往超过 30%PARSING_ERRORExif段损坏或结构非法这是唯一真正代表数据异常的错误码。库找到 APP1 段后进入extractExifData第 217 行起任何一步结构校验失败都会被包装成PARSING_ERROR。常见的校验失败点Exif 头缺失段内前 6 字节不是Exif\0\0第 227-229 行TIFF 字节序非法既不是II小端也不是MM大端第 233-241 行TIFF magic number 错误期望0x002A但实际值不符第 246-249 行触发场景包括手工拼接/裁剪损坏的 JPEG、被不正规工具清洗过元数据的图片、上传中断导致的截断文件等。项目自带的测试样张如test/evil1.jpg就是为验证解析健壮性而准备的边界样本。处理建议记录告警日志而非错误带上error.source和error.message便于事后分析坏图来源对用户上传场景可降级为元数据缺失处理不要因此拒绝图片——图片像素本身可能完全正常排查困难时可设置环境变量DEBUGexif开启库内置调试日志依赖debug包它会打印解析中断的 offset 和原始错误推荐的统一错误处理骨架回调签名为callback(error, data, source)用error.code做三分支判断即可覆盖全部场景var ExifImage require(exif).ExifImage; new ExifImage({ image: photo.jpg }, function (error, exifData) { if (error) { switch (error.code) { case NOT_A_JPEG: return rejectFormat(error); // 拒绝不是JPEG case NO_EXIF_SEGMENT: return finish(null); // 正常无元数据 case PARSING_ERROR: warn(Exif损坏, error.source, error.message); return finish(null); // 降级继续处理图片 default: return handleError(error); // 其他异常如文件读取失败 } } finish(exifData); });注意文件不存在、传入既非路径也非 Buffer 等错误不带code属性所以default分支兜底不可少。完整 API 用法见 README.md核心解析逻辑在 lib/exif/ExifImage.js入口模块为 index.js。实战检查清单✅ 用error.code分支处理而不是只看error.message文本✅NO_EXIF_SEGMENT走正常流程不打错误日志✅PARSING_ERROR降级处理 告警不拒绝合法图片✅ 日志中带上error.source定位问题图片✅ 调试时打开DEBUGexif查看解析中断位置✅ 记得兜底处理无code的异常文件读取失败等把三个错误码对应到拒绝 / 正常 / 降级三条路径你的 Exif 提取服务就能稳稳接住所有图片了。【免费下载链接】node-exifA node.js library to extract Exif metadata from images.项目地址: https://gitcode.com/gh_mirrors/no/node-exif创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考