Laravel 8 中 CORS 由 fruitcake/laravel-cors 包通过 HandleCors 中间件实现，不使用 Facade；需安装包、发布配置、注册中间件至 Kernel.php，禁用任何 Facade 相关配置或调用。
在 Laravel 8 中，不需要、也不应该为 CORS 配置 Facade。CORS 功能由 fruitcake/laravel-cors 包提供，它通过中间件（HandleCors）实现，而非门面（Facade）模式。
为什么不用 Facade？
CORS 是一个底层 HTTP 响应控制机制，发生在请求生命周期早期（尤其是预检 OPTIONS 请求），需在中间件层统一拦截和响应。Facade 本质是服务的静态代理，用于业务逻辑调用（如 Cache::get()），不参与请求分发或头信息注入——它既不处理预检请求，也无法向响应对象写入 Access-Control-Allow-* 头。
正确做法：中间件 + 配置文件
只需三步，无需任何 Facade 相关操作：
Intelligent search for agents. Multi-source retrieval with confidence scoring - web, academic, and Tavily in one unified API
下载
智能代理搜索。多源检索置信度评分 - 统一API整合网络、学术和Tavily搜索。
- 安装包：
composer require fruitcake/laravel-cors（Laravel 8 不内置，必须手动安装） - 发布配置：
php artisan vendor:publish --tag="cors"，生成config/cors.php - 注册中间件：打开
app/Http/Kernel.php，将\Fruitcake\Cors\HandleCors::class加入$middleware数组顶部（全局生效）或$middlewareGroups['api']（仅 API 路由）
常见误操作提醒
以下行为均无效或危险：
- 在
config/app.php的'aliases'里添加类似'Cors' => Fruitcake\Cors\Facade::class—— 该包根本未提供 Facade 类 - 试图用
Cors::enable()或类似静态调用控制跨域 —— 无此接口，会报错 - 在控制器里手动
return response()->withHeaders([...])模拟 CORS 头 —— 无法处理 OPTIONS 预检，且易被后续中间件覆盖
总结：Laravel 8 的 CORS 就是中间件的事，不是 Facade 的使用场景。配好 config/cors.php，挂对中间件位置，问题自然解决。
