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:cache 或 php artisan optimize，缓存就会残留
• 注意：php artisan config:clear 不清路由缓存，php artisan cache:clear 也不一定清干净（尤其 Laravel 8+）

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

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

php artisan optimize:clear

这条命令会同时清除：route、config、view、cache 四类缓存。比分别执行四条命令更可靠，也避免遗漏。

• 如果你用的是 Laravel 7 或更早版本，没有 optimize:clear，请按顺序执行：
  php artisan route:clear
  php artisan config:cl

  

  ear
  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 验证，再访问，别凭感觉。