当使用 anhskohbo/no-captcha 扩展包集成 Google reCAPTCHA 时，出现 Class 'Anhskohbo\NoCaptcha\NoCaptchaServiceProvider' not found 错误，通常源于服务提供者注册失败或 Laravel 配置文件缺失/不兼容。
当使用 anhskohbo/no-captcha 扩展包集成 google recaptcha 时，出现 `class 'anhskohbo\nocaptcha\nocaptchaserviceprovider' not found` 错误，通常源于服务提供者注册失败或 laravel 配置文件缺失/不兼容。
该错误并非表示 Composer 包未安装成功，而是 Laravel 在启动时无法加载服务提供者类——根本原因往往是 config/app.php 文件中遗漏了服务提供者注册项，或该文件本身已损坏、版本不匹配（例如在升级 Laravel 后直接覆盖了旧版 app.php，而新版本中默认不再包含第三方包的自动发现或手动注册配置）。
✅ 正确解决步骤：
-
确认包已正确安装
运行以下命令确保依赖已拉取并生成自动加载映射：<code class="bash">composer require anhskohbo/no-captcha</code>
-
手动注册服务提供者（Laravel ≤ 5.4 或禁用自动发现时）
编辑config/app.php，在'providers'数组中添加：<code class="php">Anhskohbo\NoCaptcha\NoCaptchaServiceProvider::class,</code>
并在
'aliases'数组中添加门面（可选但推荐）：<code class="php">'NoCaptcha' => Anhskohbo\NoCaptcha\Facades\NoCaptcha::class,</code>
-
发布配置文件（首次使用必需）
<code class="bash">php artisan vendor:publish --provider="Anhskohbo\NoCaptcha\NoCaptchaServiceProvider"</code>
此操作会生成
config/nocaptcha.php，用于配置 site key 和 secret key。 检查 Laravel 版本兼容性
anhskohbo/no-captcha主要适配 Laravel 5.x–6.x；若使用 Laravel 7+ 或更高版本，建议改用官方维护更活跃的替代方案（如greggilbert/recaptcha或 Laravel 9+ 原生支持的spatie/laravel-recaptcha），或确认所用包版本是否明确声明兼容当前 Laravel 版本。
⚠️ 重要提醒：
- ❌ 不要直接替换整个
config/app.php为新 Laravel 版本的默认文件（尤其升级时），这会清空所有自定义服务提供者和别名； - ✅ 推荐做法是：对比新旧
app.php，仅合并新增配置项，保留原有第三方注册； - 若项目混乱，可新建同版本 Laravel 项目，提取其干净的
config/app.php，再逐条迁移你的自定义配置。
完成上述步骤后，运行 composer dump-autoload 清理类映射，并重启开发服务器即可正常使用。
