laravel 12 docker环境下配置cors需明确设置allowed_origins为前端真实访问地址（如http://localhost:3000），避免用*配合supports_credentials，确保handlecors注册在api中间件组，并验证origin头未被nginx代理清除。
Laravel 12 配置 CORS 时若运行在 Docker 环境中，关键在于**区分开发与生产环境的域名来源，并确保容器网络不影响 Origin 判断**。Docker 本身不直接处理 CORS，但会改变请求路径、Host 头和网络拓扑，进而影响 allowed_origins 的匹配逻辑。常见问题如前端访问 http://localhost:3000，后端跑在 http://localhost:8000（宿主机）或 http://nginx:80（容器内），此时浏览器发出的 Origin 是 http://localhost:3000，而 Laravel 收到的请求头是准确的，但配置若写错就无法匹配。
确认请求 Origin 是否被正确识别
Docker 不会篡改请求头中的 Origin，但需注意：
- 前端必须通过浏览器真实访问（如
http://localhost:3000），不能用curl或 Postman 模拟——它们不触发浏览器 CORS 机制 - 若使用 Nginx 容器反向代理 Laravel（PHP-FPM），确保 Nginx 未清除或覆盖
Origin头；默认不会，但自定义配置中误加proxy_hide_header Origin会导致 Laravel 读不到该头 - 可在中间件中临时打印：
Log::info($request->headers->get('origin'));，验证实际值是否符合预期
配置 cors.php 适配 Docker 网络场景
在 config/cors.php 中，allowed_origins 应填写前端真实可访问的协议+域名+端口，而非容器服务名（如 nginx 或 web）：
minimax-mcp-docker版（适配极空间）
下载
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
- 本地开发：允许
http://localhost:3000、http://127.0.0.1:3000，甚至加上http://host.docker.internal:3000（适用于从容器内发起的前端请求） - 测试环境：如前端部署在
https://staging.myapp.com，就明确写入该域名，不要用* - 避免
allowed_origins => ['*']+supports_credentials => true组合，这会直接报错；若需 Cookie 认证，必须指定具体域名
确保中间件生效范围覆盖 API 路由
在 Docker 中运行的 Laravel 通常通过 api 中间件组暴露接口，需确认 HandleCors 已注入对应组：
- 打开
app/Http/Kernel.php - 检查
$middlewareGroups['api']数组是否包含\Fruitcake\Cors\HandleCors::class（Laravel 12 默认已集成该逻辑，但仍需确认） - 若使用 Sanctum，它会自动复用
cors.php配置，无需额外注册中间件 - 运行
php artisan config:clear && php artisan config:cache确保容器内配置已刷新
调试技巧：快速定位是哪一环失败
浏览器控制台报 CORS 错误时，分三步排查：
- 看 Network 面板中请求的 **Response Headers**：是否存在
Access-Control-Allow-Origin？若无，说明中间件未执行（路由没走 api 组 / 中间件未注册） - 若有该头但值不是请求的 Origin，说明
allowed_origins不匹配（比如漏了http://或端口） - 若出现预检（OPTIONS）失败，检查是否返回 200 且含
Access-Control-Allow-Methods等头——fruitcake/laravel-cors默认支持，无需额外处理 OPTIONS 路由
