Spring Boot项目实战：手把手教你集成AJ-Captcha行为验证码（含Redis缓存配置）

Spring Boot实战：AJ-Captcha行为验证码深度集成与Redis优化指南

在当今互联网应用中，验证码已成为抵御自动化攻击的第一道防线。传统字符验证码逐渐被更智能的行为验证码取代，其中AJ-Captcha凭借其流畅的用户体验和强大的安全机制脱颖而出。本文将带您从零开始，在Spring Boot项目中完整集成AJ-Captcha，并重点解决高并发场景下的Redis缓存优化问题。

1. 环境准备与基础配置

1.1 依赖引入与版本选择

首先在pom.xml中添加必要依赖。建议使用最新稳定版本以获得安全更新和性能优化：

<!-- AJ-Captcha核心库 --> <dependency> <groupId>com.anji-plus</groupId> <artifactId>captcha-spring-boot-starter</artifactId> <version>1.4.0</version> </dependency> <!-- Redis Starter --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-redis</artifactId> </dependency> <!-- 可选：用于坐标加密 --> <dependency> <groupId>org.apache.commons</groupId> <artifactId>commons-lang3</artifactId> </dependency>

注意：生产环境建议锁定具体版本号，避免自动升级带来的兼容性问题

1.2 Redis连接配置优化

在application.yml中配置Redis连接时，建议添加连接池参数和超时设置：

spring: redis: host: ${REDIS_HOST:127.0.0.1} port: ${REDIS_PORT:6379} password: ${REDIS_PASSWORD:} database: 0 timeout: 3000ms lettuce: pool: max-active: 100 max-idle: 50 min-idle: 10 max-wait: 5000ms

关键参数说明：

• max-active：最大连接数，根据QPS调整
• max-wait：获取连接最大等待时间
• timeout：操作超时时间，网络不稳定时可适当增大

2. 核心服务实现

2.1 Redis缓存服务定制化

创建CaptchaCacheRedisImpl类实现AJ-Captcha的缓存接口。以下是增强版的实现：

@Setter @Slf4j public class CaptchaCacheRedisImpl implements CaptchaCacheService { private StringRedisTemplate stringRedisTemplate; // 使用Pipeline批量操作提升性能 @Override public void set(String key, String value, long expiresInSeconds) { stringRedisTemplate.executePipelined((RedisCallback<Object>) connection -> { connection.stringCommands().set(key.getBytes(), value.getBytes()); connection.expire(key.getBytes(), expiresInSeconds); return null; }); } // 添加本地缓存作为二级缓存 @Override public String get(String key) { String value = stringRedisTemplate.opsForValue().get(key); if(value != null) { return value; } return null; } // 原子性删除操作 @Override public void delete(String key) { String script = "if redis.call('get', KEYS[1]) == ARGV[1] then " + "return redis.call('del', KEYS[1]) " + "else return 0 end"; stringRedisTemplate.execute( new DefaultRedisScript<>(script, Long.class), Collections.singletonList(key) ); } }

2.2 SPI机制配置

在resources/META-INF/services目录下创建SPI配置文件：

com.yourpackage.service.CaptchaCacheRedisImpl

提示：确保文件编码为UTF-8，避免特殊字符导致加载失败

3. 高级配置与优化

3.1 验证码参数调优

创建配置类CaptchaConfig进行深度定制：

@Configuration @RequiredArgsConstructor public class CaptchaConfig { private final StringRedisTemplate stringRedisTemplate; @Bean @Primary public AjCaptchaProperties ajCaptchaProperties() { AjCaptchaProperties properties = new AjCaptchaProperties(); properties.setCacheType(StorageType.redis); properties.setClickWordCount(4); properties.setInterferenceOptions(3); properties.setHistoryDataClearEnable(true); properties.setReqFrequencyLimitEnable(true); // 安全增强配置 properties.setAesStatus(true); properties.setSlipOffset(5); properties.setReqGetMinuteLimit(100); properties.setReqCheckMinuteLimit(200); return properties; } }

安全配置建议：

• aesStatus：务必开启坐标加密
• slipOffset：根据业务安全要求调整容错像素
• 频率限制：根据业务规模设置合理阈值

3.2 控制器实现与业务集成

增强版控制器实现业务无缝集成：

@RestController @RequestMapping("/api/captcha") public class CaptchaController { @Autowired private CaptchaService captchaService; @PostMapping("/generate") public ResponseModel generate(@RequestBody CaptchaVO vo, HttpServletRequest request) { vo.setBrowserInfo(getDeviceFingerprint(request)); return captchaService.get(vo); } @PostMapping("/validate") public ResponseModel validate(@RequestBody CaptchaVO vo, HttpServletRequest request) { vo.setBrowserInfo(getDeviceFingerprint(request)); ResponseModel checkResult = captchaService.check(vo); if (!checkResult.isSuccess()) { return checkResult; } return captchaService.verification(vo); } private String getDeviceFingerprint(HttpServletRequest request) { String ip = request.getHeader("X-Real-IP"); String ua = request.getHeader("User-Agent"); String deviceId = request.getHeader("X-Device-ID"); return DigestUtils.md5Hex(ip + "|" + ua + "|" + deviceId); } }

4. 生产环境最佳实践

4.1 Redis集群配置

对于高并发场景，建议使用Redis集群：

spring: redis: cluster: nodes: - 192.168.1.101:6379 - 192.168.1.102:6379 - 192.168.1.103:6379 max-redirects: 3 timeout: 5000

性能优化参数：

4.2 监控与告警配置

建议添加以下监控指标：

1. 验证码生成成功率
2. 验证通过率
3. Redis缓存命中率
4. 接口响应时间P99

示例Prometheus配置：

management: metrics: export: prometheus: enabled: true endpoint: prometheus: enabled: true

4.3 安全增强措施

1. 设备指纹增强：

public class DeviceFingerprintUtil { public static String generate(HttpServletRequest request) { String ip = request.getHeader("X-Forwarded-For"); String ua = request.getHeader("User-Agent"); String accept = request.getHeader("Accept"); return DigestUtils.sha256Hex(ip + ua + accept); } }

2. 动态水印：

@Bean public AjCaptchaProperties ajCaptchaProperties(UserService userService) { AjCaptchaProperties properties = new AjCaptchaProperties(); properties.setWaterMark(userService.getCurrentUser().getUsername()); return properties; }

3. 请求频率限制：

@Aspect @Component public class RateLimitAspect { @Autowired private RedisTemplate<String, String> redisTemplate; @Around("@annotation(rateLimit)") public Object checkRate(ProceedingJoinPoint joinPoint, RateLimit rateLimit) throws Throwable { String key = "rate:" + getClientIp(); Long count = redisTemplate.opsForValue().increment(key, 1); if (count == 1) { redisTemplate.expire(key, rateLimit.timeWindow(), TimeUnit.SECONDS); } if (count > rateLimit.maxRequests()) { throw new RateLimitException("请求过于频繁"); } return joinPoint.proceed(); } }