Zxing生成二维码扫不出的主因是默认透明背景和字符集不匹配：需改用BufferedImage.TYPE_INT_RGB并填充白色背景，且必须显式设EncodeHintType.CHARACTER_SET为"UTF-8"；解析时应确保图像类型为TYPE_INT_RGB或TYPE_BYTE_GRAY。
Zxing 生成二维码本身很简单，但实际项目里出问题的几乎全是图片编码、字符集、容错级别和解析时的预处理环节。
为什么 MatrixToImageWriter.toBufferedImage() 生成的二维码扫不出来
常见现象是：生成的图片在手机上扫不出内容，或只在部分扫码器上能识别。根本原因不是 Zxing 写错了，而是默认用 BufferedImage.TYPE_INT_ARGB 创建图像，带透明通道——多数扫码器（尤其是微信、支付宝）对透明背景兼容极差。
- 务必改用
BufferedImage.TYPE_INT_RGB，强制无透明通道 - 如果原图底色需为白色，手动填充背景：
graphics.setColor(Color.WHITE); graphics.fillRect(0, 0, width, height); - 别依赖
MatrixToImageWriter.writeToFile()默认行为，它底层也走TYPE_INT_ARGB，容易踩坑
EncodeHintType.CHARACTER_SET 不设会乱码，但设错更糟
中文内容不指定字符集，Zxing 默认用平台默认编码（如 Windows 上是 GBK），而 Android 或 Linux 服务端多是 UTF-8，一来一回就变问号或方块。
- 必须显式传
EncodeHintType.CHARACTER_SET→"UTF-8" - 千万别写成
"utf8"或"UTF8"—— Zxing 内部用Charset.forName()查找，大小写敏感且不接受缩写 - 如果输入字符串本身已损坏（比如从数据库读出来就是乱码），Zxing 无法挽救，得往前查源头
解析图片时 BufferedImageLuminanceSource 报 NotFoundException 的真实原因
不是二维码质量差，而是 luminance source 没适配图像类型。Zxing 的 BufferedImageLuminanceSource 只支持 TYPE_BYTE_GRAY 和 TYPE_INT_RGB，其他类型（比如 TYPE_3BYTE_BGR 或带 alpha 的图）会直接抛异常或返回空结果。
立即学习“Java免费学习笔记（深入）”；
- 加载图片后先检查：
image.getType()，非TYPE_INT_RGB就转：new BufferedImage(width, height, BufferedImage.TYPE_INT_RGB) - 别跳过灰度转换步骤：用
Graphics2D绘制原图到新 BufferedImage，否则 luminance source 拿不到稳定亮度值 - 小图（ImageUtils.scale() 放大到 200px+ 再解析，Zxing 对低分辨率容忍度很低
用 MultiFormatReader 解析时要不要加 DecodeHintType.TRY_HARDER
加了不一定更好，反而可能拖慢 3–5 倍，还容易误识别噪声点。它只在两种场景真正有用：
- 二维码严重变形（如贴在曲面、被拉伸）且你确定内容简单（纯数字/短链接）
- 图片极暗或反色（白底黑码变成黑底白码），Zxing 默认假设是“黑码白底”
- 日常扫码（截图、相机直拍）完全不用开；开了反而让
HybridBinarizer多跑几轮二值化，增加失败概率
真正该调的是 DecodeHintType.POSSIBLE_FORMATS，比如只收 BarcodeFormat.QR_CODE，避免 Zxing 浪费时间试 DataMatrix 或 PDF417。
