集成ReCaptcha V3的Livewire联系表单报错求助

错误根源 #

你在Livewire组件里调用了Http::post()，但没有导入Laravel官方的Http门面类，Laravel会默认在当前命名空间App\Http\Livewire下查找Http类，自然找不到对应文件。

修复及优化步骤 #

1. 导入Http门面 #

在Livewire组件顶部的use语句区域添加Http门面的导入：

use Illuminate\Support\Facades\Http;

修改后的组件头部use代码块如下：

namespace App\Http\Livewire;

use Livewire\Component;
use App\Mail\ContactMail;
use App\Models\Contact;
use App\Http\Requests\ContactFormRequest;
use Illuminate\Support\Facades\Mail;
use Illuminate\Support\Facades\Http; // 新增此行

2. 规范HTTP请求写法（推荐） #

原代码直接拼接URL参数的方式不够安全和易维护，建议改为传递参数数组的形式：

$response = Http::post('https://www.google.com/recaptcha/api/siteverify', [
    'secret' => env('CAPTCHA_SECRET_KEY'),
    'response' => $token,
]);

3. 修正reCAPTCHA分数判断逻辑（重要） #

原代码的分数判断逻辑写反了：reCAPTCHA V3的分数范围是0-1，分数越高越倾向于是正常用户，正确逻辑应该是分数大于0.3时允许提交，否则提示疑似机器人：

public function updatedCaptcha($token)
{
    $response = Http::post('https://www.google.com/recaptcha/api/siteverify', [
        'secret' => env('CAPTCHA_SECRET_KEY'),
        'response' => $token,
    ]);
    $this->captcha = $response->json()['score'];

    if ($this->captcha > 0.3) {
        $this->send();
    } else {
        session()->flash('error', 'Google检测到您可能是机器人，请刷新页面重试');
    }
}

同时建议将提示的success改为error，符合错误提示的语义。

4. 环境变量调用优化（可选） #

直接在代码中使用env()函数不推荐，建议新建config/captcha.php配置文件：

return [
    'secret_key' => env('CAPTCHA_SECRET_KEY'),
    'site_key' => env('CAPTCHA_SITE_KEY'),
];

之后在代码中通过配置文件调用：

'secret' => config('captcha.secret_key'),

这样在缓存配置后能提升应用性能。

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