如何通过ThinkPHP调整路由缓存设置以加快路由匹配速度？

本文共计928个文字，预计阅读时间需要4分钟。

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() 或闭包定义的路由，缓存机制会退化：

立即学习“PHP免费学习笔记（深入）”；

• 闭包路由（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，避免注释干扰路由缓存的哈希计算（极少数情况会导致缓存命中失败）

事情说清了就结束。