路由缓存开关在config/route.php或config/app.php中配置route_cache布尔值,默认开启;开发设false,线上设true;多应用需各配;闭包路由无法缓存,静态数组式可全缓存。

路由缓存开关在哪配:route_cache 配置项位置
ThinkPHP 的路由缓存不是靠命令行或环境变量控制,而是直接写在配置文件里。默认开启,但很多人改了路由规则却没清缓存,结果新路由死活不生效——问题就出在这儿。
- 路由缓存开关是布尔值,配置项叫
route_cache,必须放在config/route.php或应用级配置(如config/app.php)中,不能写在config/cache.php里 - 开发阶段建议设为
false;线上部署后务必设为true,否则每次请求都全量解析路由,性能掉得明显 - 如果用的是多应用模式,每个应用的
config/route.php都要单独配,主配置不继承
示例(config/route.php):
return [
'route_cache' => true,
];
为什么改了路由没反应:缓存文件没删干净
路由缓存生成后会写入 runtime/cache/ 目录下的 PHP 文件(如 route.php),但 ThinkPHP 不会自动检测源路由文件修改时间,也不会自动刷新——它只认缓存文件是否存在。
- 清缓存不能只删
runtime/cache/,还要确保runtime/route/(旧版路径)或runtime/cache/route.php(新版)被彻底删除 - 使用
php think clear:route命令最稳妥;手动删的话,注意有些 IDE 或编辑器会临时生成同名隐藏文件,导致缓存“看似删了实则还在” - 在 Swoole 或 Hyperf 兼容模式下,如果用的是常驻内存服务,光删文件不够,还得 reload 进程,否则旧缓存仍被加载到内存里
Route::rule() 和闭包定义路由时,缓存行为有差异
静态数组式路由(如 return ['index' => 'index/index'];)能被完整缓存;但用 Route::rule() 或闭包定义的路由,缓存机制会退化:
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景,三层路由架构(触发词→SAD反馈→DAG编排),recall@10=96.97%。配置驱动(chains.yaml),零代码扩展。pip install skill-weave-chains 一键安装。
- 闭包路由(
Route::get('test', function(){}))无法被缓存,每次请求都会重新执行闭包注册逻辑 -
Route::rule()定义的路由可以缓存,但它的中间件、参数绑定等动态行为仍需运行时解析,缓存只加速匹配路径字符串那一环 - 如果大量使用闭包或动态
Route::import(),开路由缓存收益极小,甚至可能因反复初始化反而更慢
建议:核心路由走配置数组,调试/临时接口才用闭包
上线前漏掉的检查点:缓存路径权限和 OPCache 干扰
runtime/cache/ 目录若不可写,ThinkPHP 会静默失败,既不报错也不生成缓存文件,结果就是“开了缓存等于没开”。
- 检查 Web 用户(如 www-data、nginx)对
runtime/及其子目录是否有写权限,尤其 Docker 容器里容易因 UID 不一致导致权限丢失 - 启用 OPCache 时,如果
opcache.enable_cli=1且你用 CLI 清缓存,可能导致缓存文件被 OPCache 锁住,Web 请求读到的是旧字节码 - 生产环境建议关掉
opcache.save_comments,避免注释干扰路由缓存的哈希计算(极少数情况会导致缓存命中失败)
事情说清了就结束。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










