laravel 新增或修改路由后仍返回 404，通常不是代码错误，而是因启用了路由缓存却未及时刷新所致；执行 `php artisan route:clear` 或 `php artisan optimize`（laravel 8+ 推荐用 `route:clear` + `config:clear`）即可解决。
在 Laravel 中，当你向 routes/api.php（或 web.php）新增一条路由，例如：
Route::get('/registrator', [\App\Http\Controllers\RegistrationController::class, 'index']);即使控制器方法 index() 已正确定义并返回简单值（如 return 1;），该路由仍可能持续返回 HTTP 404 Not Found —— 这往往并非路由注册失败，而是 Laravel 的路由缓存机制在作祟。
? 为什么会这样？
Laravel 在生产环境（或手动执行过缓存命令）下会将所有路由编译为静态数组并缓存到 bootstrap/cache/routes-v7.php（版本相关）。此时，框架将完全忽略 routes/ 目录下的 PHP 文件变更，直接读取缓存文件。因此，无论你如何修改 api.php 或控制器，只要缓存未清除，新路由就永远不会被识别。
你观察到“把 /airport 改成 /airportt 后仍 404，改回才恢复”，正是典型缓存残留现象：旧缓存中仍存在 /airport，而 /registrator 根本未被写入缓存。
✅ 正确的解决步骤（推荐 Laravel 8+）
# 1. 清除路由缓存（必需） php artisan route:clear # 2. 清除配置缓存（避免 config 配置影响路由加载） php artisan config:clear # 3. （可选）重载自动加载优化（尤其修改了命名空间或类路径后） composer dump-autoload
⚠️ 注意：php artisan optimize 在 Laravel 6+ 已被弃用，Laravel 9+ 中该命令不存在；它曾等价于 config:cache + route:cache + view:cache，但route:cache 仅支持非闭包、非动态参数的路由（你的 RegistrationController@index 完全兼容），不过开发阶段强烈不建议启用 route:cache，因其会掩盖路由定义问题。
✅ 验证是否生效
执行完清理命令后，重启开发服务器（如果使用 php artisan serve，需手动重启）：
php artisan serve
然后访问 http://localhost:8000/api/registrator（注意：api.php 中的路由默认带 /api 前缀），应成功返回 1。
? 额外检查项（排除其他可能）
- ✅ 确认控制器命名空间与文件路径一致：App\Http\Controllers\RegistrationController 对应 app/Http/Controllers/RegistrationController.php；
- ✅ 检查 use 语句无误（你已正确声明 use Illuminate\Http\Request;）；
- ✅ 确保未在中间件中拦截该路由（如 auth:sanctum 或自定义中间件）；
- ✅ 使用 php artisan route:list 查看当前已加载的路由（该命令会自动触发缓存刷新，是调试路由的黄金命令）：
php artisan route:list --path=registrator
若列表中未出现 /registrator，说明缓存未清或路由未被加载；若已出现但访问仍 404，请检查 URL 前缀（API 路由默认为 /api/registrator）和 HTTP 方法（确保用 GET 请求）。
✅ 总结
| 场景 | 推荐操作 |
|---|---|
| 开发阶段新增/修改路由 | 执行 php artisan route:clear && php artisan config:clear |
| 生产环境部署后更新路由 | 部署脚本中加入 route:clear 和 config:clear（禁用 route:cache 除非确认全静态路由） |
| 调试路由是否存在 | php artisan route:list \| grep registrator |
记住：缓存是为了性能，不是为了阻碍开发。养成“改路由 → 清缓存 → 验证”的习惯，就能彻底告别神秘的 404。
