frankenphp 下 cache:clear 不刷新路由缓存，因其绕过 cli 预热流程、不自动执行路由编译，且 worker 进程复用旧类定义；需手动 cache:warmup、启用 auto_reload、重启进程并确保权限与 autoload 正确。
cache:clear 为什么在 FrankenPHP 下不刷新路由缓存
FrankenPHP 不会自动触发 Symfony 的路由编译流程，cache:clear 命令本身能清空缓存文件，但路由定义（尤其是注解或属性路由）的解析和 PHP 字节码生成依赖于请求进入时的运行时环境 —— 而 FrankenPHP 的 SAPI 模式与传统 PHP-FPM 或 CLI 有本质差异：它把 PHP 当作嵌入式引擎直接处理 HTTP 请求，绕过了标准的 CLI 缓存预热路径。
典型现象是：php bin/console cache:clear 执行成功、var/cache/dev/ 目录被清空，但访问新路由仍报 No route found for "GET /xxx"；同时 php bin/console debug:router 却能正确列出该路由 —— 这说明路由定义已加载，但运行时未生效。
- FrankenPHP 默认禁用
opcache.preload，且不执行SymfonyComponentHttpKernelCacheWarmerCacheWarmerAggregate中的路由预热逻辑 - 控制器类若通过注解（
@Route）或 PHP 属性（#[Route]）定义路由，其解析发生在第一次请求时，而 FrankenPHP 可能复用未更新的类映射或注解缓存 -
APP_ENV=dev下 Symfony 本应动态重载路由，但 FrankenPHP 的文件监听机制（如 inotify）未被默认启用或不可靠
如何让新路由在 FrankenPHP 中立即生效
不能只依赖 cache:clear，必须强制触发路由编译并确保其被 FrankenPHP 加载。关键不是“清缓存”，而是“让路由定义真正进入运行时类图”。
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 手动执行路由缓存预热：
php bin/console cache:warmup --env=prod（即使开发环境也建议跑一次），这会生成var/cache/prod/srcApp_KernelProdContainer.php及关联的路由映射文件 - 确认
frankenphp.yaml中启用了auto_reload: true（仅限开发模式），并检查是否设置了watch_files包含src/Controller/和config/routes/ - 重启 FrankenPHP 实例（不是 reload）：FrankenPHP 的 worker 进程持有 PHP 类定义，修改控制器后必须 kill 并重新启动
frankenphp进程，否则旧类仍在内存中 - 避免混合使用注解与属性路由：FrankenPHP 对 PHP 8.2+ 属性解析更稳定，
@Route注解需额外加载doctrine/annotations，且其反射缓存容易 stale；统一用#[Route]更可靠
验证路由是否真被 FrankenPHP 加载
光看 debug:router 输出不够，得确认该路由定义是否进入了当前 FrankenPHP worker 的类加载上下文。
- 在控制器方法开头加一行：
throw new Exception('Route loaded: ' . $_SERVER['REQUEST_URI'] ?? 'unknown');，然后访问路径 —— 如果没抛异常，说明请求根本没进控制器，路由未匹配 - 检查
var/log/dev.log中是否有Matched route日志；没有则证明路由解析阶段就失败了，不是缓存问题，而是 FrankenPHP 未正确扫描控制器目录 - 确认
composer.json的autoload配置包含"psr-4": {"App\": "src/"}，且src/Controller/下的文件名符合 PascalCase（如RegisterController.php），FrankenPHP 对文件系统大小写和命名更敏感 - 临时在
config/packages/framework.yaml中显式启用路由扫描：routing: { annotations: true, attributes: true }，避免依赖自动发现
FrankenPHP 特有的路径与权限陷阱
FrankenPHP 以 root 或非 www-data 用户运行时，容易因权限导致路由元数据无法写入或读取，进而静默跳过路由加载。
-
var/cache/目录必须对 FrankenPHP 进程用户可读写；若用docker run启动，需加-u $(id -u):$(id -g)确保 UID/GID 一致 - 不要把
src/放在 symlink 目录下：FrankenPHP 默认禁用opcache.enable_file_override，symlink 会导致注解/属性解析失败，表现为路由完全不可见 - 检查
phpinfo()页面中的Server API是否为FrankenPHP；如果是cli，说明你正在用命令行执行命令，而非在 FrankenPHP 上下文中运行 —— 两者缓存完全隔离
opcache 未配置 validate_timestamps=1 导致 PHP 类定义长期滞留内存。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
