PHP缓存旧路由致404怎么清_PHP缓存路由404清理法【诀窍】

Laravel路由缓存导致404,需执行php artisan optimize:clear(Laravel 8+)或依次运行route:clear、config:clear、view:clear、cache:clear,并重启PHP服务及检查Web服务器伪静态和OPcache。

PHP 缓存旧路由导致 404,本质是 Laravel(或其他框架)把过期的路由配置固化在缓存文件里,routes/web.php 改了但服务器还在用旧的映射表——所以访问新路径直接 404,连错误日志都不报。

确认是不是路由缓存惹的祸

运行 php artisan route:list,看输出里有没有你刚加的路由(比如 /dashboard)。如果没出现,基本可以断定:Laravel 没读到你的修改,不是代码写错,而是缓存挡路了。

  • 常见假象:改完 routes/

    web.php
    ,刷新浏览器还是 404,甚至 php artisan serve 重启也不管用
  • 根本原因:Laravel 在生产环境默认启用路由缓存,开发时若误执行过 php artisan route:cachephp artisan optimize,缓存就会残留
  • 注意:php artisan config:clear 不清路由缓存,php artisan cache:clear 也不一定清干净(尤其 Laravel 8+)

清空路由缓存的正确命令组合

别只敲一个 cache:clear ——它不碰路由缓存。必须用专门指令,且推荐统一使用 Laravel 8+ 的新命令,兼容性更好、清理更彻底:

php artisan optimize:clear

这条命令会同时清除:routeconfigviewcache 四类缓存。比分别执行四条命令更可靠,也避免遗漏。

  • 如果你用的是 Laravel 7 或更早版本,没有 optimize:clear,请按顺序执行:
    php artisan route:clear
    php artisan config:clear
    php artisan view:clear
    php artisan cache:clear
  • 执行后务必检查输出是否含 Route cache cleared! 字样,否则说明没清成功
  • 清完别忘了重启服务:php artisan serve 前先按 Ctrl + C 停掉旧进程

容易被忽略的两个“缓存陷阱”

即使清了 Laravel 缓存,404 还在?那可能是 Web 服务器或 PHP 自身在“记仇”:

  • Apache/Nginx 伪静态规则缓存:比如宝塔面板用了旧版 Laravel 伪静态模板,或 Nginx 配置里漏了 try_files $uri $uri/ /index.php?$query_string;,请求压根没进 PHP,直接被服务器判为 404。此时清 Laravel 缓存毫无意义
  • PHP OPcache 未重置:某些部署环境(如宝塔 + PHP 8.4)中,OPcache 会缓存已编译的 PHP 文件字节码。改了 routes/web.php,但 OPcache 还在用旧字节码,route:list 看不到新路由。解决方法:service php-fpm-84 restart(以实际服务名为准)

真正卡住人的,往往不是 Laravel 缓存本身,而是你以为清完了,其实 Web 服务器或 OPcache 还在固执地返回旧结果。每次清完,务必跑一遍 php artisan route:list 验证,再访问,别凭感觉。