php artisan route:cache 会跳过闭包路由，因为 PHP 无法序列化 Closure，Laravel 在 RouteCollection::compile() 中直接忽略闭包路由并警告，导致其不出现在 routes-v7.php 中而引发 404。
为什么 php artisan route:cache 会跳过闭包路由？
因为 Laravel 路由缓存本质是把所有注册的路由序列化后写入 bootstrap/cache/routes-v7.php（版本相关），而 PHP 无法序列化闭包（Closure）。执行缓存命令时，Laravel 内部调用 RouteCollection::compile()，遇到 Closure 类型的 action 就直接跳过该路由，并打印警告：Unable to cache routes using Closure actions. Please use controller actions instead.
闭包路由在缓存前后的行为差异
未缓存时，闭包路由能正常工作——Laravel 在每次请求中动态调用它；但一旦启用缓存，这些路由就彻底从缓存文件中消失，导致 404。这不是「不生效」，而是「根本没被收录」。
-
开发环境常写
Route::get('/test', function () { return 'ok'; });，本地跑得通，上线执行route:cache后访问直接 404 - 缓存文件里只包含
Controller@method格式的数组结构，例如['as' => 'home', 'uses' => 'App\Http\Controllers\HomeController@index'] - 闭包无法转成可持久化的字符串结构，PHP 的
serialize()对Closure抛出Exception: Serialization of 'Closure' is not allowed
如何快速定位哪些路由是闭包？
运行 php artisan route:list，观察 Action 列：凡显示为 Closure 的，就是问题路由。也可以用以下命令快速过滤：
php artisan route:list --format=json | php -r "
\$r = json_decode(file_get_contents('php://stdin'), true);
foreach (\$r['data'] as \$route) {
if (strpos(\$route['Action'], 'Closure') !== false) {
echo \"\${route['Method']} \${route['URI']} → \${route['Action']}\n\";
}
}"
常见来源包括：临时调试路由、第三方包未适配的注册方式、旧版文档遗留写法。
替代方案与注意事项
必须用控制器方法替代闭包，但要注意命名和可见性：
- 控制器方法需为
public，且不能带参数类型声明以外的依赖（Laravel 5.8+ 支持自动注入，但构造函数或方法参数不能含闭包/资源等不可序列化对象） - 避免使用
__invoke单动作控制器配合闭包逻辑——如果 invoke 方法内部又 new 了闭包，照样无法缓存 - 测试阶段可用
APP_ENV=local php artisan route:cache强制跳过缓存（仅限开发），但别误提交到生产环境 - 某些场景（如多租户动态路由）确实需要运行时生成，那就只能放弃
route:cache，改用route:clear+ 优化 RouteServiceProvider 的boot()加载逻辑
最易被忽略的一点：Composer 自动加载器变更后，即使你改了控制器类名，也得先 composer dump-autoload，否则缓存写入时可能因类找不到而静默失败。
