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

第三步：完善细节

• 正则表达式写完要多测几个边界用例，贪心和转义最容易出错。
• 权限不足导致的报错往往信息不明确，排查时别忘了检查文件和目录权限。
• 不要在线上环境直接调试，复制一份数据到本地慢慢查。
• 官方文档永远是最权威的资料，博客只能作为补充。

回顾一下

写到这里，关于生成图片验证码的主要内容就齐了。如果你身边有正在学习Java的朋友，不妨把这篇文章转给他。

遇见问题加 QQ23979811 协助处理