Laravel9与10路由区别详解

学习文章要努力，但是不要急！今天的这篇文章《Laravel9与Laravel10路由差异解析》将会介绍到等等知识点，如果你想深入学习文章，可以关注我！我会持续更新相关文章的，希望对大家都能有所帮助！

Laravel 10 移除了 RouteServiceProvider 中默认命名空间绑定逻辑，导致 Route::get('/home', 'HomeController@index') 报错“Class not found”；必须改用显式导入+数组语法 Route::get('/home', [HomeController::class, 'index'])。

Class "XXXController" not found 错误从哪来？

升级到 Laravel 10 后，Route::get('/home', 'HomeController@index') 这种写法直接报错，提示 Class "HomeController" not found。这不是控制器文件丢了，而是 Laravel 10 彻底移除了 RouteServiceProvider 中默认的命名空间绑定逻辑——它不再自动把字符串控制器名补上 App\Http\Controllers\ 前缀。

• Laravel 9 及更早：路由组默认走 $this->namespace = 'App\Http\Controllers'，所以字符串写法能“猜”对类位置
• Laravel 10：该属性被删除，namespace() 方法调用也从 mapWebRoutes() 中移除，字符串控制器彻底失效
• IDE 不再能跳转、重构会断链、类型推导失效——隐式行为消失后，工具链立刻“显形”

必须改用 [Controller::class, 'method'] 语法

这是 Laravel 10 官方唯一推荐且向后兼容的控制器路由写法，核心是显式导入 + 数组回调形式。

• 先在 routes/web.php 顶部加 use App\Http\Controllers\HomeController;
• 再写路由：Route::get('/home', [HomeController::class, 'index']);
• 不支持 ['HomeController', 'index'] 这种字符串数组，必须是 Controller::class 常量
• 闭包路由、资源路由（Route::resource()）不受影响，只约束控制器方法绑定方式

想临时保留旧写法？可以但不建议

如果你有大量遗留路由要一次性迁移，或团队过渡期需要缓冲，可以在 RouteServiceProvider 里手动加回 namespace() 分组——但这只是权宜之计。

• 在 app/Providers/RouteServiceProvider.php 的 mapWebRoutes() 方法中，把原生的 group(base_path('routes/web.php')) 包进命名空间分组：
• Route::middleware('web')->namespace('App\\Http\\Controllers')->group(base_path('routes/web.php'));
• 注意双反斜杠转义，Windows 路径下容易漏写；PHP 8.1+ 会警告未声明的动态类名
• 这种写法绕过了框架演进意图，新项目、新控制器务必坚持 FQCN 写法

API 路由和中间件分组也要同步处理

别只改 web.php，api.php 和自定义中间件分组同样适用这套规则。比如带前缀和中间件的 API 组：

• 错误写法：Route::prefix('v1')->middleware('auth:sanctum')->group(function () { Route::get('/users', 'UserController@index'); });
• 正确写法：use App\Http\Controllers\Api\UserController; + Route::get('/users', [UserController::class, 'index']);
• 如果控制器在子命名空间（如 Api\），必须完整导入，不能靠分组自动拼接
• 资源路由同理：Route::resource('posts', PostController::class); —— 注意这里传的是类名，不是字符串

最常被忽略的一点：所有控制器类名必须真实存在、路径匹配 PSR-4、且没有拼写大小写错误。Laravel 10 不再帮你“宽容”地尝试各种组合，它只认你写的那个 Controller::class 常量指向的绝对路径。

好了，本文到此结束，带大家了解了《Laravel9与10路由区别详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！