Spring Boot中JUnit测试QR码解码遇com.google.zxing.NotFoundException问题求助

1. 检查位图预处理逻辑 #

zxing解码器对输入位图的格式、清晰度要求严格，先排查预处理环节：

• 强制将彩色图转为灰度图：避免彩色通道干扰解码，示例代码：

  BufferedImage grayImage = new BufferedImage(originalImg.getWidth(), originalImg.getHeight(), BufferedImage.TYPE_BYTE_GRAY);
  Graphics2D g = grayImage.createGraphics();
  g.drawImage(originalImg, 0, 0, null);
  g.dispose();
  

• 替换二值化器：如果默认的HybridBinarizer失效，尝试使用GlobalHistogramBinarizer，适合对比度较高的图像：

  BinaryBitmap binaryBitmap = new BinaryBitmap(new GlobalHistogramBinarizer(new BufferedImageLuminanceSource(grayImage)));
  

2. 配置解码提示参数 #

默认解码逻辑未开启容错和全格式支持，显式添加DecodeHintType提升成功率：

Map<DecodeHintType, Object> hints = new HashMap<>();
// 启用所有条码格式（仅需QR码可指定EnumSet.of(BarcodeFormat.QR_CODE)）
hints.put(DecodeHintType.POSSIBLE_FORMATS, EnumSet.allOf(BarcodeFormat.class));
// 开启深度解码模式，处理模糊/变形的QR码
hints.put(DecodeHintType.TRY_HARDER, Boolean.TRUE);
// 指定字符集，避免编码不匹配
hints.put(DecodeHintType.CHARACTER_SET, "UTF-8");

MultiFormatReader reader = new MultiFormatReader();
reader.setHints(hints);
Result result = reader.decode(binaryBitmap);

3. 验证测试QR码有效性 #

• 确认测试用QR码无损坏、像素足够：建议使用分辨率≥200x200的清晰二维码，避免过小或模糊的图像
• 检查QR码内容编码：如果包含非UTF-8字符，在CHARACTER_SET中指定对应编码（如GBK、ISO-8859-1）

4. 排查依赖兼容性 #

• 确保项目中zxing的core和javase版本一致：3.5.1版本的javase依赖对应core:3.5.1，避免版本冲突
• 尝试升级至最新稳定版（如3.5.3），修复旧版本存在的解码bug

5. 调试输出位图 #

如果以上步骤无效，将处理后的位图保存到本地，确认图像是否符合预期：

ImageIO.write(grayImage, "PNG", new File("debug-qr.png"));

查看保存的图片，确认二维码未被裁剪、旋转或变色。

内容的提问来源于stack exchange，提问作者Sercan Noyan Germiyanoğlu