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 常量指向的绝对路径。
