Java 生成图片验证码常见问题汇总（完整版）

生成图片验证码到底解决了什么问题？

最近在项目里重度用到了生成图片验证码，踩过一些坑，也总结出一些心得。趁记忆还新鲜，整理成文，供同样在用Java的朋友参考。

生成图片验证码实战要点拆解

1. 使用生成图片验证码前先想清楚它解决的是什么问题，避免拿着锤子找钉子。
2. 记录生成图片验证码使用过程中踩过的坑，形成自己的避坑手册。
3. 定期回顾自己写的生成图片验证码相关代码，随着经验增长总能发现改进空间。
4. 处理生成图片验证码时考虑异常路径：网络断了、文件不存在、权限不够，分别怎么办。

理解了底层逻辑，使用起来才能游刃有余。

写一段生成图片验证码的代码

下面这段代码演示了生成图片验证码：

public static String captcha(OutputStream out) throws Exception {
    int w = 120, h = 40;
    BufferedImage img = new BufferedImage(w, h, BufferedImage.TYPE_INT_RGB);
    Graphics2D g = img.createGraphics();
    g.setColor(Color.WHITE);
    g.fillRect(0, 0, w, h);
    String chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";  // 去掉易混淆字符
    StringBuilder code = new StringBuilder();
    Random r = new Random();
    for (int i = 0; i < 4; i++) {
        char c = chars.charAt(r.nextInt(chars.length()));
        code.append(c);
        g.setColor(new Color(r.nextInt(150), r.nextInt(150), r.nextInt(150)));
        g.drawString(String.valueOf(c), 20 + i * 25, 28);
    }
    g.dispose();
    ImageIO.write(img, "png", out);
    return code.toString();   // 存入 session 用于校验
}

常见问题与注意事项

• 服务器时间要校准，分布式系统里时间差能引发诡异问题。
• 路径问题在 Windows 和 Linux 下表现不同，跨平台开发时尤其要注意斜杠方向。
• 文档和代码要同步更新，过期文档比没有文档更害人。

结语

总结一下：生成图片验证码的重点是理解适用场景，难点是处理边界情况，关键是多写多练。三者兼顾，想不掌握都难。

---

遇见问题加 QQ23979811 协助处理