ZXing系列工具无法识别特定二维码的问题求助

算力阿峰

2026-6-27

问题

我有一个示例二维码：

SecScanQR应用可正常解析它，其源码显示使用ZXing Library。但我使用最新版ZXing.Net（ZXing的.NET移植版本）解析同一二维码时，却无法识别任何内容，代码如下：

Bitmap bitmap = System.Drawing.Image.FromFile(@"d:\Temp\1.bmp") as Bitmap;
var bSource = new BitmapLuminanceSource(bitmap);
BinaryBitmap bbMap2 = new BinaryBitmap(new HybridBinarizer(bSource));
Result result0 = new MultiFormatReader().decode(bbMap2);
if (result0 != null)
{
    Console.WriteLine(result0.BarcodeFormat.ToString());
    Console.WriteLine(result0.Text);
}

更奇怪的是，ZXing在线扫描器也无法识别该二维码。我很困惑，据我所知QR码规范多年未变，这是什么原因？

可能的原因及解决方法

非标准QR码兼容差异：部分第三方工具生成的二维码可能存在轻微的规范偏离（比如定位点尺寸、模块排列细节），SecScanQR大概率做了自定义的容错兼容优化，而官方ZXing系列（包括ZXing.Net和在线扫描器）遵循严格规范，对这类“变种码”识别门槛更高。
图像预处理缺失：你的代码直接读取BMP文件解析，未做任何预处理，可尝试以下操作：
- 调整图像的对比度、亮度，强化二维码区域的黑白反差
- 裁剪图像至仅保留二维码核心区域，减少无关像素干扰
- 替换二值化器：用GlobalHistogramBinarizer替代HybridBinarizer，后者更适配渐变背景，但如果二维码本身对比度低，前者的识别效果可能更稳定

解码参数未优化：默认解码参数的容错和扫描强度不足，可自定义参数提升识别概率：

var options = new DecodingOptions
{
    PossibleFormats = new List<BarcodeFormat> { BarcodeFormat.QR_CODE },
    TryHarder = true, // 启用更耗时但精度更高的扫描模式
    CharacterSet = "UTF-8"
};
Result result0 = new MultiFormatReader().decode(bbMap2, options);