Magento2创建客户Rest API ReCaptcha验证失败，求非关闭绕过方案

问题说明 #

调用{url}/index.php/rest/V1/customers创建客户时，已传入g-recaptcha-response参数，但仍返回错误：

{
"message": "ReCaptcha validation failed, please try again"
}

关闭后台ReCaptcha配置后接口可正常工作，需在保留ReCaptcha功能的前提下解决该问题。

可行解决方案 #

1. 校验ReCaptcha响应的有效性

• 确保g-recaptcha-response是从Google ReCaptcha服务实时获取的有效令牌，过期、伪造或跨IP生成的令牌会直接验证失败。
• 核对后台ReCaptcha版本配置（v2/v3）：若使用v3，需确认令牌的分数符合后台设置的阈值；v2则需确保令牌是通过前端交互正常生成的。
• 验证请求IP与生成ReCaptcha令牌的IP一致，Google会校验IP匹配性，跨IP请求会导致验证失败。

2. 使用可信集成令牌绕过验证

针对可信的API调用场景，可通过Magento2集成令牌跳过ReCaptcha验证：

1. 后台创建集成（System > Extensions > Integrations），分配Customers > All权限，生成API令牌。
2. 请求时在Header中添加Authorization: Bearer {集成令牌}，此时Magento会判定为可信系统请求，跳过前端ReCaptcha校验。
   示例请求：

curl -X POST "{url}/index.php/rest/V1/customers" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_INTEGRATION_TOKEN" \
-d '{
    "customer": {
        "email": "user@example.com",
        "firstname": "John",
        "lastname": "Doe",
        "storeId": 1,
        "websiteId": 1
    },
    "password": "Demo1234"
}'

3. 自定义模块跳过API请求的ReCaptcha

通过自定义模块重写ReCaptcha验证逻辑，针对REST API请求跳过校验：

1. 创建自定义模块，重写Magento\ReCaptchaCustomer\Model\Registration类：

<?php
namespace YourVendor\YourModule\Model;

use Magento\Framework\App\RequestInterface;
use Magento\ReCaptchaCustomer\Model\Registration as OriginalRegistration;

class Registration extends OriginalRegistration
{
    public function isRequired(RequestInterface $request): bool
    {
        // 判断是否为REST API请求
        if (strpos($request->getPathInfo(), '/rest/') !== false) {
            return false;
        }
        return parent::isRequired($request);
    }
}

2. 在模块的di.xml中配置重写：

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <preference for="Magento\ReCaptchaCustomer\Model\Registration" type="YourVendor\YourModule\Model\Registration" />
</config>

4. 检查后台ReCaptcha场景配置

进入后台Stores > Configuration > Security > Google ReCaptcha，确认Customer Registration的ReCaptcha仅针对前端表单启用，部分Magento版本支持针对不同场景（前端/API）单独配置验证规则。

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