你是否在寻找用Java实现验证码生成与验证的案例

wen java案例 2026-06-05 47

本文目录导读：

📖 目录导读
验证码技术的核心价值与选型分析
Java实现验证码生成的三步曲
验证码验证的Session与Redis双方案
细颗粒度实战：Kaptcha与Hutool的封装技巧
问答专区：高频Bug与性能优化20问
全文精华总结与源码获取指引

Java验证码生成与验证全攻略：从登录防刷到高并发场景实战

📖 目录导读

验证码技术的核心价值与选型分析
Java实现验证码生成的三步曲：图形、字符与噪声
验证码验证的Session与Redis双方案对比
细颗粒度实战：Kaptcha与Hutool的封装技巧
问答专区：高频Bug与性能优化20问
全文精华总结与源码获取指引

验证码技术的核心价值与选型分析

你是否在寻找用Java实现验证码生成与验证的案例？ 这个问题背后通常藏着三个真实需求：

防止恶意机器人在登录页疯狂撞库
降低注册/发帖接口被脚本攻击的风险
实现符合《网络安全法》的人机验证要求

当前主流方案分为三类：

图形验证码（经典方案，占市场80%以上）
滑块验证码（交互友好，需额外开发行为分析）
短信/邮件验证码（安全等级高，但有成本）

本文聚焦图形验证码的Java原生实现与工业级封装，所有代码均兼容Spring Boot 2.x/3.x。

Java实现验证码生成的三步曲

1 核心依赖选择（Maven示例）

<!-- 方案1：Google Kaptcha（轻量级首选） -->
<dependency>
    <groupId>com.github.penggle</groupId>
    <artifactId>kaptcha</artifactId>
    <version>2.3.2</version>
</dependency>
<!-- 方案2：Hutool工具包（一切从简） -->
<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.22</version>
</dependency>

2 原生手写验证码生成器

public class CaptchaGenerator {
    // 关键参数配置
    private static final int WIDTH = 120;
    private static final int HEIGHT = 40;
    private static final int CODE_LENGTH = 4;
    public static BufferedImage generate(String code) {
        BufferedImage image = new BufferedImage(WIDTH, HEIGHT, BufferedImage.TYPE_INT_RGB);
        Graphics2D g = image.createGraphics();
        // 步骤1：绘制背景与干扰线（防机器识别）
        g.setColor(Color.LIGHT_GRAY);
        g.fillRect(0, 0, WIDTH, HEIGHT);
        g.setColor(Color.BLACK);
        for (int i = 0; i < 20; i++) { // 随机干扰线
            int x1 = ThreadLocalRandom.current().nextInt(WIDTH);
            int y1 = ThreadLocalRandom.current().nextInt(HEIGHT);
            int x2 = x1 + ThreadLocalRandom.current().nextInt(20);
            int y2 = y1 + ThreadLocalRandom.current().nextInt(20);
            g.drawLine(x1, y1, x2, y2);
        }
        // 步骤2：绘制验证码字符（扭曲+颜色随机）
        Font font = new Font("Arial", Font.BOLD, 28);
        g.setFont(font);
        for (int i = 0; i < code.length(); i++) {
            int angle = ThreadLocalRandom.current().nextInt(-30, 31);
            g.setColor(new Color(ThreadLocalRandom.current().nextInt(256),
                    ThreadLocalRandom.current().nextInt(256),
                    ThreadLocalRandom.current().nextInt(256)));
            g.drawString(String.valueOf(code.charAt(i)), 
                    15 + i * 25, 
                    30 + ThreadLocalRandom.current().nextInt(5));
        }
        // 步骤3：添加噪点（100-200个随机像素点）
        for (int i = 0; i < 150; i++) {
            g.setColor(new Color(ThreadLocalRandom.current().nextInt(256),
                    ThreadLocalRandom.current().nextInt(256),
                    ThreadLocalRandom.current().nextInt(256)));
            g.drawRect(ThreadLocalRandom.current().nextInt(WIDTH),
                    ThreadLocalRandom.current().nextInt(HEIGHT), 1, 1);
        }
        g.dispose();
        return image;
    }
}

3 验证码字符串生成规则

// 混合数字+字母（排除易混淆字符0/O/1/I/L）
public static String getRandomCode(int length) {
    String chars = "ABCDEFGHJKLMNPQRSTUVWXYZ23456789";
    StringBuilder sb = new StringBuilder();
    for (int i = 0; i < length; i++) {
        sb.append(chars.charAt(ThreadLocalRandom.current().nextInt(chars.length())));
    }
    return sb.toString();
}

验证码验证的Session与Redis双方案

1 传统Session方案（适合单机部署）

@RestController
public class CaptchaController {
    @GetMapping("/captcha")
    public void getCaptcha(HttpServletRequest request, HttpServletResponse response) throws IOException {
        String code = CaptchaGenerator.getRandomCode(4);
        request.getSession().setAttribute("captchaCode", code); // 存入Session
        BufferedImage image = CaptchaGenerator.generate(code);
        ImageIO.write(image, "JPEG", response.getOutputStream());
    }
    @PostMapping("/verify")
    public String verify(@RequestParam String inputCode, HttpSession session) {
        String realCode = (String) session.getAttribute("captchaCode");
        return inputCode.equalsIgnoreCase(realCode) ? "✅ 验证通过" : "❌ 验证码错误";
    }
}

2 分布式Redis方案（生产环境推荐）

@RestController
public class RedisCaptchaController {
    @Autowired
    private RedisTemplate<String, String> redisTemplate;
    @GetMapping("/redis-captcha")
    public void getCaptcha(@RequestParam String uuid, HttpServletResponse response) throws IOException {
        String code = CaptchaGenerator.getRandomCode(4);
        redisTemplate.opsForValue().set("captcha:" + uuid, code, 5, TimeUnit.MINUTES);
        BufferedImage image = CaptchaGenerator.generate(code);
        ImageIO.write(image, "JPEG", response.getOutputStream());
    }
    @PostMapping("/redis-verify")
    public String verify(@RequestParam String uuid, @RequestParam String inputCode) {
        String realCode = redisTemplate.opsForValue().get("captcha:" + uuid);
        if (realCode == null) return "⚠️ 验证码已过期，请重新获取";
        return inputCode.equalsIgnoreCase(realCode) ? "✅ 通过" : "❌ 错误";
    }
}

关键差异：Redis方案需要前端传递唯一uuid，验证后立即删除缓存（防重复使用）。

细颗粒度实战：Kaptcha与Hutool的封装技巧

1 Kaptcha生产级配置

@Bean
public DefaultKaptcha getKaptcha() {
    DefaultKaptcha dk = new DefaultKaptcha();
    Properties prop = new Properties();
    prop.setProperty("kaptcha.border", "yes");
    prop.setProperty("kaptcha.border.color", "105,179,90");
    prop.setProperty("kaptcha.textproducer.font.color", "blue");
    prop.setProperty("kaptcha.image.width", "125");
    prop.setProperty("kaptcha.image.height", "45");
    prop.setProperty("kaptcha.textproducer.font.size", "40");
    prop.setProperty("kaptcha.session.key", "code");
    prop.setProperty("kaptcha.textproducer.char.space", "4");
    prop.setProperty("kaptcha.obscurificator.impl", "com.google.code.kaptcha.impl.WaterRipple");
    Config config = new Config(prop);
    dk.setConfig(config);
    return dk;
}

2 Hutool一行搞定（极致简洁）

@GetMapping("/hutool-captcha")
public void hutoolCaptcha(HttpServletResponse response) {
    // 生成线段干扰验证码（支持CircleCaptcha、ShearCaptcha等）
    ShearCaptcha captcha = CaptchaUtil.createShearCaptcha(200, 100, 4, 4);
    // 核心：验证码字符串自动存入Session，key为captcha.captchaStorage
    captcha.write(response.getOutputStream());
    // 从Session获取验证码（Hutool自动配置）：CaptchaUtil.getCaptcha("captcha.captchaStorage") 
}

问答专区：高频Bug与性能优化20问

Q1: 验证码生成后返回给前端的Base64格式怎么实现？
A: 将BufferedImage转为ByteArrayOutputStream，再用Base64.getEncoder().encodeToString(bytes)拼接成“data:image/jpeg;base64,”字符串。

Q2: 如何防止验证码被OCR识别？
A: 组合使用“字符旋转+随机颜色+复杂背景+艺术字体”，建议采用kaptcha的WaterRipple实现水波纹扭曲。

Q3: 高并发下验证码性能瓶颈在哪？
A: 主要在图像生成时的Graphics2D操作，优化策略：

提前生成验证码图片池（预生成1000张存Redis）
使用new BufferedImage时指定TYPE_INT_RGB而非默认值
配合CDN缓存静态资源,动态生成只走API

Q4: 验证码的时效性如何设计？
A: 登录验证推荐5分钟+验证后立即删除；支付/敏感操作推荐1分钟+验证码与手机号绑定。

Q5: 前后端分离时session无法共享怎么办？
A: 必须使用Redis方案，前端每次请求携带uuid参数，服务端从Redis取出验证码进行比较。

Q6: 如何实现点击“换一张”刷验证码？
A: 前端定时器setInterval每60秒自动刷新，或点击事件重新请求API并更新uuid。

Q7: 验证码图片空白或显示异常？
A: 检查ImageIO.write()的格式参数，JPEG不支持透明度需改用PNG；response.setContentType必须设为“image/jpeg”。

Q8: 生产环境是否需要限制验证码生成频率？
A: 强烈建议！通过Redis记录IP+接口路径，同一IP每分钟最多生成3次验证码（防止刷接口消耗资源）。

Q9: 是否支持国际化验证码？
A: 可以，替换字符集为中文汉字（需加载中文字体）或拼音，但识别难度和用户体验需平衡。

Q10: 验证码能自动过期吗？
A: Redis方案直接设置TTL；Session方案需在Filter中维护定时清理任务，推荐使用Spring的@Scheduled(cron="0 0/1 * * * ?")每分钟清理一次。

全文精华总结与源码获取指引

本文通过原生手写、Kaptcha、Hutool三个维度，拆解了Java验证码的全套实现逻辑，核心要点：

安全基线：字符数≥4，干扰线≥20条，噪点≥100个，有效期≤5分钟
架构选择：单机用Session，分布式必须用Redis+UUID
性能红线：单次生成耗时控制在<30ms，每秒可承载≥100TPS

如果你正在寻找一个可直接运行的Spring Boot验证码Demo，按照本文代码即可零门槛构建。技术选型建议：中小型项目用Hutool的ShearCaptcha，大型高并发场景用Kaptcha配合Redis存储，现在就开始动手，为你的系统加一道人机验证的铜墙铁壁吧！

（本文结束）