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 四类缓存。比分别执行四条命令更可靠，也避免遗漏。
立即学习“PHP免费学习笔记（深入）”；
- 如果你用的是 Laravel 7 或更早版本，没有
optimize:clear，请按顺序执行：php artisan route:clearphp artisan config:clearphp artisan view:clearphp 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 验证，再访问，别凭感觉。
