如何将隐形reCaptcha集成到基于Spring Boot的Java应用中
Spring Boot 集成静默reCaptcha实现方案
前置准备
- 申请reCaptcha v2隐形版的密钥对:站点密钥(Site Key)、密钥(Secret Key),注意Secret Key属于敏感信息,禁止泄露到前端。
前端适配(后端验证依赖前端返回的token)
静默reCaptcha无需用户手动触发验证,前端仅需要完成2项适配:
- 页面引入reCaptcha的JS资源
- 绑定表单提交事件,提交时自动调用reCaptcha接口获取
response token,和表单业务参数一起传给后端接口
Spring Boot后端集成步骤
1. 配置通用HTTP请求工具
示例用Spring Boot内置的RestTemplate实现请求,无需额外引入第三方依赖,先注册RestTemplate的Bean:
import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.web.client.RestTemplate; @Configuration public class RestTemplateConfig { @Bean public RestTemplate restTemplate() { return new RestTemplate(); } }
2. 配置reCaptcha参数
在application.yml或者application.properties中添加配置项:
recaptcha: secret: 你申请到的Secret Key verify-url: https://www.google.com/recaptcha/api/siteverify
3. 编写验证相关实体类
示例代码用了Lombok简化实体类的get/set方法,如果你项目没有引入Lombok,手动给实体类添加对应getter、setter方法即可。
验证请求参数实体:
import lombok.Data; @Data public class RecaptchaVerifyRequest { // 后端存储的Secret Key private String secret; // 前端传递的验证token private String response; // 可选:用户IP,可提升验证准确率 private String remoteip; }
验证响应结果实体:
import lombok.Data; import java.util.List; @Data public class RecaptchaVerifyResponse { // 验证是否通过 private boolean success; // 验证发起的时间戳 private String challenge_ts; // 验证请求的站点域名 private String hostname; // 验证失败时返回的错误码列表 private List<String> errorCodes; }
4. 封装验证服务类
import org.springframework.beans.factory.annotation.Value; import org.springframework.stereotype.Service; import org.springframework.util.LinkedMultiValueMap; import org.springframework.util.MultiValueMap; import org.springframework.web.client.RestTemplate; @Service public class RecaptchaService { @Value("${recaptcha.secret}") private String recaptchaSecret; @Value("${recaptcha.verify-url}") private String recaptchaVerifyUrl; private final RestTemplate restTemplate; public RecaptchaService(RestTemplate restTemplate) { this.restTemplate = restTemplate; } public boolean verify(String responseToken, String userIp) { MultiValueMap<String, String> params = new LinkedMultiValueMap<>(); params.add("secret", recaptchaSecret); params.add("response", responseToken); if (userIp != null && !userIp.isBlank()) { params.add("remoteip", userIp); } RecaptchaVerifyResponse response = restTemplate.postForObject( recaptchaVerifyUrl, params, RecaptchaVerifyResponse.class ); return response != null && response.isSuccess(); } }
5. 业务接口调用验证
以登录接口为例:
import org.springframework.web.bind.annotation.PostMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; import javax.servlet.http.HttpServletRequest; @RestController public class LoginController { private final RecaptchaService recaptchaService; public LoginController(RecaptchaService recaptchaService) { this.recaptchaService = recaptchaService; } @PostMapping("/login") public String login( @RequestParam String username, @RequestParam String password, @RequestParam String recaptchaToken, HttpServletRequest request ) { // 优先执行reCaptcha验证 String userIp = request.getRemoteAddr(); boolean verifyPass = recaptchaService.verify(recaptchaToken, userIp); if (!verifyPass) { return "验证失败,疑似机器人操作"; } // 验证通过后执行原有账号密码校验等业务逻辑 // ... 原有业务代码 return "登录成功"; } }
注意事项
- 如果国内服务器无法访问Google的验证接口,可以替换为国内可访问的镜像地址,或者给服务配置代理
- 前端获取的token有效期只有2分钟,且仅能使用一次,需要保证提交请求时实时生成token
- 所有验证逻辑必须在后端执行,禁止在前端做验证结果判断,避免被恶意绕过
- 可以根据业务需求对验证失败的请求做频率限制,进一步降低攻击风险
内容的提问来源于stack exchange,提问作者user16347624
相关产品推荐
相关产品推荐

