Java 生成图片验证码完整指南

在正式开始之前，先问一个问题：你真的了解生成图片验证码吗？不是「听说过」那种了解，而是「能讲清楚、能写对」那种。如果答案不确定，这篇文章值得一读。

第一步：先搞懂生成图片验证码是什么

团队协作中，生成图片验证码的用法约定要写进开发规范，避免各写各的。

不要迷信生成图片验证码的某种「最佳实践」，结合自己的业务场景做判断。

第二步：用代码实现生成图片验证码

生成图片验证码：

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 用于校验
}

第三步：检查与优化

1. 重要功能上线前，先写好回滚方案，再点开始按钮。
2. 接口返回的数据结构要和文档核对，字段名大小写都可能踩坑。
3. 遇到诡异问题试试最小化复现：把无关代码都删掉，问题往往立刻现形。

结语

本文没有覆盖生成图片验证码的所有细节，但已经把最高频、最易错的部分讲清楚了。剩下的细节，实践中自然会遇到并掌握。

遇见问题加 QQ23979811 协助处理