条码扫不出来，最贵的做法是直接换识别库——因为很多时候瓶颈根本不在算法，而在图像：打印发虚让边缘糊成一团、强光把局部冲成一片白、拍摄角度吃掉了本该有的静区。这些问题的麻烦在于，解码器只会告诉你「失败」，不会告诉你「为什么」。 在线条码可扫性分析器（英文名 Online Barcode Scanability Analyzer）补的就是这一环：即使解码彻底失败，它也能对图像本身做量测，把可疑点、量测值和证据不足项分开列出来，并且从不把猜测说成结论。
在线演示
在线条码可扫性分析器（英文名 Online Barcode Scanability Analyzer）：打开就能用，不需要注册；图像量测、对比实验和报告生成都在浏览器内完成，图片不会上传服务器。
配合本文验证时可以这样走一遍：选一张内置的困难样本跑默认识别，失败后点「Draw a region」把整个条码连同一点干净留白框起来，先读图像发现，再跑五种对比实验，看是哪一个变量让读取器改了主意。
关键要点
- 手动框选分析直接读源像素，SDK 初始化失败、定位失败、解码失败都不影响它工作。
- 每行结论带三种状态：Potential issue（可疑项）、Measurement only（仅量测）、Inconclusive（证据不足，明确不算通过）。
- 边缘发虚的判定有完整算法：每个轴向取 9 条扫描线，统计灰度变化 ≥40 级的单调过渡，过渡宽度中位数（10%–90%）超过 3 像素才报警。
- 五种对比实验共享同一框选区域：原图裁剪、反相、灰度拉伸、旋转 90 度、2 倍最近邻放大（超过 800 万像素输出上限时跳过放大）。
- 一键把原图和文件名通过 IndexedDB 递给条码参数调优器继续调参；记录只消费一次、一小时过期。
- 上传上限 30 MB、2400 万像素，保留原始分辨率；透明通道按白底合成。
图像量测：不依赖 SDK 的那部分
框选一个区域后，页面立刻对这块像素做一组量测，这一步完全不经过识别 SDK：
- 灰度分布：百分位灰度范围、偏亮像素的亮度——判断这块区域是不是对比度不足或局部过曝。
- 边缘过渡宽度：每个轴向采样 9 条扫描线，找灰度单调变化 ≥40 级的过渡，取总变化更强的那个轴，统计 10%–90% 过渡宽度的中位数，超过 3 像素标记为「边缘发虚」。采样密度超过每样本 1.5 源像素时直接标 Inconclusive，因为插值已经污染了量测。
- 暗像素占比：框内侧边缘一圈里暗内容超过 20%（且灰度范围 ≥70）会给出「框选或留白」提示——注意这是几何线索，不是符号学意义上的静区合规检查。
- 对边几何失配：从相对两条边采的剖面互相比较，差异过大提示透视形变——但它是双线性采样，不是标定过的投影变换，检不出所有形变。
这套量测最克制的地方式它的诚实：报告没有综合质量分，没有绿色「质检通过」；运动模糊、高光、破损这些无法从单帧可靠推断的缺陷干脆不设占位指标，宁可不说。
五种对比实验：一次排除一个变量
「Try decoding selected area」和「Run decoding comparisons」是可选实验，不是诊断结论。五个实验对同一框选区域各跑一次默认模板识别：
| 实验 | 排除的变量 |
|---|---|
| 原图裁剪 | 全图里其他内容、噪声区域的干扰 |
| 颜色反相 | 反色条码（白底黑字 ↔ 黑底白字） |
| 灰度百分位拉伸 | 对比度不足 |
| 旋转 90 度 | 扫描方向敏感性 |
| 2 倍最近邻放大 | 模块尺寸过小 |
每个实验显示测试图、确切操作、解码文本和耗时。所有实验都失败时，报告明确写「失败原因未解释」，而不是挑一个看起来合理的替罪羊；原图裁剪就成功时，说明限制扫描区域本身就改变了读取器行为——这已经是有用信息，但同样不等于找到了原始失败的原因。确认解码文本时要人工核对，别把旁边的码当成目标。
证据分级与流转
页面顶部有一份可见图例，每一行发现都带状态。这套分级的价值在团队协作里：当你把导出的 JSON 报告发给同事，「Inconclusive」不会被读成「没问题」，「Potential issue」自带证据和下一步建议。
如果结论指向「参数问题」而不是「图像问题」，下一步就是在线条码参数调优器：分析器通过同源 IndexedDB 把原图 PNG 和文件名递过去，调优器页面直接载入。传输记录只消费一次、一小时后过期，存储失败时退回手动上传。整条链路不离开浏览器。
最后重申边界：这是一台软件预检工具。它能告诉你「图像有哪些可疑、值得重拍或调参」，但不能替代 ISO 认证检测仪给出打印等级，也不能证明「任何设置下都读不出来」——默认模板失败只说明默认模板失败。