zxing报writerexception主因是参数越界或类型不匹配：content非空且url编码后≤2953字节、宽高≥100、bufferedimage需type_int_argb；swing显示需正确转imageicon并调revalidate/repaint；关键encodehinttype仅error_correction、character_set、margin；jar缺失zxing-javase依赖或未设headless模式亦致失败。
生成二维码时 ZXing 报 WriterException 怎么快速定位？
绝大多数报这个错不是因为编码逻辑错了，而是输入参数越界或类型不匹配。比如传了负数宽高、空字符串内容、或用 BufferedImage 时颜色模型不支持 ARGB。
-
content必须非空且 URL 编码后长度不能超过 QR 码容量（L 级别下约 2953 字节），中文要先URLEncoder.encode(str, "UTF-8") -
width/height必须 ≥ 100，否则某些版本MatrixToImageWriter会直接抛异常 - 别直接 new
QRCodeWriter()后调encode()返回BitMatrix就完事——得检查bitMatrix.getWidth() > 0再进下一步，否则后续转图必崩
Swing 界面里显示二维码图片，为什么 JLabel.setIcon() 不生效？
常见原因是没把生成的 BufferedImage 正确转成 ImageIcon，或者 Swing 组件没触发重绘。
Java JDK 25
下载
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
- 别用
new ImageIcon(bufferedImage)后直接 set，要确保bufferedImage是 TYPE_INT_ARGB 类型；否则在某些 JDK 版本（如 8u202）上图标变黑或空白 - 推荐写法：
new ImageIcon(bufferedImage.getScaledInstance(width, height, Image.SCALE_SMOOTH))，避免缩放失真 - 设置完记得调
label.revalidate()和label.repaint()，尤其在非 EDT 线程生成图片后更新 UI 时
ZXing 的 EncodeHintType 哪些参数真正影响输出效果？
实际开发中只用关注三个：容错级别、字符编码、边距。其他 hint 多数被忽略或仅在特定格式下生效。
-
EncodeHintType.ERROR_CORRECTION推荐用ErrorCorrectionLevel.H（最高容错），但文件体积略大；L级别扫码失败率明显上升，尤其手机摄像头偏暗时 -
EncodeHintType.CHARACTER_SET必须显式设为"UTF-8"，否则中文默认按 ISO-8859-1 编码，扫出来是乱码 -
EncodeHintType.MARGIN默认是 4，设为 0 虽然省空间，但部分扫码器（如微信）会拒识——建议保持 ≥ 2
打包成 jar 后二维码生成功能失效，错误里带 NoClassDefFoundError: com/google/zxing/WriterException
不是代码问题，是依赖没打进 jar。Maven 构建时若只用 mvn package，zxing-core 和 zxing-javase 不会自动合并进去。
- 用
maven-shade-plugin打 fat jar，注意配置minimizeJar设为 false，否则可能删掉 ZXing 的反射所需类 - 别漏掉
zxing-javase——它提供MatrixToImageWriter，纯core包里没有图像转换能力 - 运行时如果提示
java.awt.HeadlessException，说明服务器环境没图形界面，需加 JVM 参数-Djava.awt.headless=true，ZXing 在 headless 模式下仍可生成BufferedImage
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
