BigCommerce测试环境自动化：如何禁用/绕过Google reCAPTCHA v2

1. 编程方式禁用reCAPTCHA的可行方案 #

BigCommerce平台下，是否能编程禁用reCAPTCHA取决于你的开发层级（后台配置/自定义主题/自建应用）：

• 后台配置层面：测试环境可直接在BigCommerce店铺后台的「设置」-「安全」里找到reCAPTCHA开关手动关闭；如果要自动化控制，可通过BigCommerce的Admin API调用对应配置接口修改reCAPTCHA状态。
• 自定义主题/模板层面：如果使用Stencil主题，可在登录页、注册页等模板文件中加入环境判断逻辑，比如检测店铺的测试环境标识或自定义环境变量，处于测试环境时跳过reCAPTCHA脚本的加载代码块。示例代码：

  {{#unless is_test_environment}}
    <div class="g-recaptcha" data-sitekey="YOUR_REAL_SITEKEY"></div>
  {{/unless}}
  

• 自建BigCommerce应用层面：如果是你开发的集成reCAPTCHA的应用，可在代码中加入测试环境判断，比如读取环境变量TEST_MODE=true时，不初始化reCAPTCHA实例，或替换为无功能的模拟组件。

2. 无法禁用时的可靠绕过方案 #

如果因为平台限制或第三方集成无法禁用，可通过以下几种稳定方式绕过reCAPTCHA v2：

• 使用Google官方测试密钥：Google为reCAPTCHA提供了专门的测试密钥，在测试环境替换为这些密钥后，所有验证请求会自动通过，无需人工操作：
  • 测试Site Key：6LeIxAcTAAAAAJcZVRqyHh71UMIEGNQ_MXjiZKhI
  • 测试Secret Key：6LeIxAcTAAAAAGG-vFI1TnRWxMZNFuojJ4WifJWe
    只需在BigCommerce后台或自定义代码中替换为这组密钥，E2E测试时reCAPTCHA会直接显示验证成功状态。
• 自动化工具模拟验证完成：针对已加载的reCAPTCHA，可通过执行JavaScript直接填充验证令牌并触发回调。以Cypress为例：

  cy.get('#g-recaptcha-response').then($el => {
    $el.val('dummy-valid-token');
  });
  // 触发页面的验证回调（根据页面实际回调函数调整）
  cy.window().trigger('recaptchaVerified');
  

  注意：部分页面会对令牌做校验，这种方法仅适合测试环境或配合测试密钥使用。
• 拦截验证请求并返回成功响应：用E2E工具的网络拦截功能，拦截reCAPTCHA的验证接口请求，直接返回成功结果。以Playwright为例：

  await page.route('https://www.google.com/recaptcha/api/siteverify', route => {
    route.fulfill({
      status: 200,
      contentType: 'application/json',
      body: JSON.stringify({ success: true })
    });
  });
  

  这种方法无需修改页面代码，直接在测试层面拦截处理，稳定性较高。

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