如何在XUnit注册集成测试中获取Google reCAPTCHA响应

你在注册表单的XUnit集成测试里卡到reCAPTCHA响应这一步很正常——毕竟测试环境里没有真实用户通过浏览器完成验证，直接写Request.Equals["g-recaptcha-response"]肯定行不通，测试上下文里根本不存在这个HTTP请求对象，而且这行代码的语法逻辑本身也有问题。

先帮你捋下当前代码里的明显问题：

• Google_recaptcha = Request.Equals["g-recaptcha-response"]完全错误：测试代码里没有Request上下文，Equals也不是获取表单值的方法
• 最后验证逻辑configuration.GetUserByEmail(payload.Google_recaptcha, true)逻辑颠倒：你是想用reCAPTCHA响应去查用户？应该用注册时的邮箱才对

下面给你几个实用的解决方案，按测试场景的适配度排序：

方案1：测试环境直接绕过reCAPTCHA验证（最推荐） #

集成测试的核心是验证注册流程本身，没必要在测试里依赖外部的reCAPTCHA服务。你可以在API后端加个开关：

• 通过环境变量（比如APP_ENV=Test）判断是否跳过验证
• 或者给测试请求加个特殊请求头，后端检测到就跳过reCAPTCHA校验

修改你的测试代码如下：

[Fact] 
// 创建新用户注册 
/// 在stp租户下可用，新租户不可用(需添加新法律声明) 
public async Task Should_Successfully_Register_User_With_Skipped_ReCAPTCHA()
{ 
    var url = $"{servicePath}/api/userregistration?api-version={configuration.ApiVersion}"; 
    var payload = new UserRegistrationSubmitFormModel() { 
        MailAddress = GenerateRandomString(8) + "@stp-online.de", 
        Password = "sfsfsf", 
        Language = "en-en", 
        OriginalApplication = configuration.Config["OriginalApplication"], 
        UserIPAddress = IPAddress.Parse("127.7.4.73"), 
        // 测试环境随便填个值即可，后端会跳过验证
        Google_recaptcha = "test-recaptcha-dummy-value"
    }; 

    // 添加租户请求头
    httpClient.DefaultRequestHeaders.Add("STP-SUBDOMAIN", "stp");
    // 添加跳过reCAPTCHA的特殊标识头
    httpClient.DefaultRequestHeaders.Add("X-Skip-ReCAPTCHA", "true");

    var response = await httpClient.PostAsJsonAsync(url, payload); 
    var responseContent = await response.Content.ReadAsStringAsync(); 

    Assert.True(response.IsSuccessStatusCode); 
    Assert.Equal(HttpStatusCode.OK, response.StatusCode); 

    // 修正验证逻辑：用注册邮箱查询用户
    var registeredUser = await configuration.GetUserByEmail(payload.MailAddress, true); 
    Assert.NotNull(registeredUser);
}

方案2：使用Google官方测试密钥 #

Google提供了专门用于测试的reCAPTCHA密钥，无论你提交什么响应值，验证都会返回成功：

• 站点密钥：6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
• 密钥：6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe

你可以在测试环境的配置里替换成这些密钥，然后在测试代码里随便填一个响应值即可：

Google_recaptcha = "any-test-response-value"

方案3：模拟reCAPTCHA验证逻辑（适合单元测试） #

如果是更细粒度的单元测试，你可以把reCAPTCHA验证抽象成接口，测试时模拟这个接口的返回值：

// 先定义验证接口
public interface IRecaptchaValidator
{
    Task<bool> ValidateAsync(string response, string userIp);
}

// 测试时用Mock框架模拟验证成功
var mockValidator = new Mock<IRecaptchaValidator>();
mockValidator.Setup(v => v.ValidateAsync(It.IsAny<string>(), It.IsAny<string>()))
             .ReturnsAsync(true);

// 把模拟对象注入到你的注册服务中
var registrationService = new UserRegistrationService(mockValidator.Object, ...);

不过这个方案更适合单元测试，你的场景是集成测试，前两种方案会更贴合需求。

最后提个醒：集成测试尽量避免依赖外部服务，既影响测试速度，又可能因为外部服务不稳定导致测试失败。

内容的提问来源于stack exchange，提问作者Aleksandar Todorov