NelmioCorsBundle在FrankenPHP下不生效的根本原因是请求未进入Symfony内核：FrankenPHP默认绕过PHP-FPM，若路由被误判为静态资源则直接返回，CorsListener完全不触发；需检查frankenphp.yaml/Caddyfile路由配置、强制fallback至PHP处理、避免allow_origin:['*']与supports_credentials:true共存，并重启FrankenPHP进程而非仅清缓存。
NelmioCorsBundle 在 FrankenPHP 下大概率不生效，根本原因不是配置写错，而是请求根本没进 Symfony 内核——FrankenPHP 默认绕过 PHP-FPM，直接用 Swoole 处理静态资源和部分路由，CORS 中间件压根没机会执行。
FrankenPHP 会跳过 Symfony 的 Kernel 请求生命周期
FrankenPHP 启动时默认启用 static_files 和 php 路由规则，若前端请求路径（如 /api/v1/users）被误匹配为“可静态处理”，就会直接返回 404 或空响应，Nelmio\CorsBundle\EventListener\CorsListener::onKernelRequest 根本不会触发。
- 检查
frankenphp.yaml或Caddyfile中是否定义了类似handle_path /api/*但未显式 fallback 到 PHP 处理器 - 运行
php bin/console debug:router确认路由存在后，在控制器开头加dump('hit'); die;—— 若没输出，说明请求没到 Symfony - 临时把所有路由强制走 PHP：在
frankenphp.yaml中设handle_path /*并指定php处理器，验证是否恢复 CORS 响应头
allow_origin: ['*'] 与 supports_credentials 冲突在 FrankenPHP 更易暴露
FrankenPHP 对响应头更敏感，尤其当 Nginx 或 Caddy 层已注入部分 CORS 头时，Symfony 再写一遍会导致浏览器拒绝（例如 Access-Control-Allow-Origin 出现两次）。而 allow_credentials: true + allow_origin: ['*'] 这种组合在 FrankenPHP 下会直接让 OPTIONS 请求卡死，连 405 都不返回。
- 必须把
nelmio_cors.yaml中的allow_origin改成明确列表，如['http://localhost:3000', 'https://app.example.com'] - 确认前端发请求时带了
credentials: 'include'，否则后端设supports_credentials: true没意义 - 用
curl -I -X OPTIONS http://localhost:8080/api/v1/users直接测，看响应头里有没有Access-Control-Allow-Credentials: true和匹配的Access-Control-Allow-Origin
prod 缓存未清 + FrankenPHP worker 复用导致旧配置残留
FrankenPHP 的 PHP worker 是长生命周期的，php bin/console cache:clear --env=prod 只清 Symfony 缓存，但 worker 进程可能还拿着旧容器实例。改完 nelmio_cors.yaml 后，光清缓存不够，必须重启 FrankenPHP 进程。
立即学习“PHP免费学习笔记（深入）”；
- 改配置后执行：
php bin/console cache:clear --env=prod && sudo systemctl restart frankenphp（若用 systemd） - 或杀掉所有 FrankenPHP worker：
pkill -f frankenphp，再手动启动 - 检查
var/cache/prod/Container*/srcApp_KernelProdContainer.php是否包含你新写的 CORS 规则关键词，避免 YAML 解析失败静默降级
FrankenPHP 的“快”是以牺牲传统 PHP 生命周期可见性为代价的，跨域问题卡住时，优先确认请求是否真进了 Symfony，而不是一头扎进 YAML 文件调参数。
