You need to enable JavaScript to run this app. 如何将隐形reCaptcha集成到基于Spring Boot的Java应用中
优惠活动
大模型
产品
解决方案
定价
更多

如何将隐形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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.14 15:54:10