laravel 11 要求控制器路由必须使用类常量语法并严格匹配命名空间、目录结构与文件名，字符串写法已弃用；需确认控制器路径、namespace 声明、类名以 controller 结尾，并通过 route:list、dump-autoload 和 url 访问三步验证。
在 Laravel 11 中，控制器路由写法已全面收紧类型安全与命名空间校验机制，字符串风格的 'App\Http\Controllers\XxxController@index' 不再被推荐，且部分旧写法在严格模式下直接报错；必须改用类常量语法并确保命名空间、目录结构、文件名三者完全一致才能通过路由注册。
确认控制器文件位置与命名空间是否匹配
打开终端，进入项目根目录，执行 ls app/Http/Controllers/，确认你要绑定的控制器（如 UserController.php）真实存在于该路径下——【Laravel 11 默认不扫描子目录，若控制器在 app/Http/Controllers/Admin/UserController.php，则必须手动声明命名空间为 App\Http\Controllers\Admin】。
用编辑器打开该控制器文件，检查顶部 namespace 声明是否为 namespace App\Http\Controllers;（无空格、无拼写错误、首字母大写 App）；若在子目录中，必须同步改为 namespace App\Http\Controllers\Admin;。
检查类名是否以 Controller 结尾，例如 class UserController extends Controller —— 少一个 Controller 或多一个 s（如 UserControllers）都会导致类加载失败。
路由定义必须使用数组语法 + 类常量
打开 routes/web.php 或 routes/api.php，找到对应路由行，将旧写法：
Route::get('/users', 'UserController@index');
立即替换为：
use App\Http\Controllers\UserController;
→ Route::get('/users', [UserController::class, 'index']);
如果控制器在子命名空间下（如 Admin），则 use 语句必须完整：use App\Http\Controllers\Admin\UserController;，否则 PHP 解析时会找不到类。
你也可以跳过 use，直接写全路径：Route::get('/users', [\App\Http\Controllers\Admin\UserController::class, 'index']);——这种写法在 IDE 中补全略差，但可避免命名冲突，适合临时调试。
验证路由是否生效的三步检查
第一步：运行 php artisan route:list --name=users（把 users 换成你实际的路由名或路径关键词），确认输出中存在该路由且 controller 列显示为 App\Http\Controllers\UserController@index 格式；若显示为 NULL 或空白，说明命名空间未解析成功。
第二步：执行 composer dump-autoload 强制刷新自动加载映射——这一步不是每次都要做，但当你刚创建控制器或修改了命名空间后，它能立刻暴露路径不一致问题。
第三步：访问对应 URL，观察是否返回 404 还是 Class 'App\Http\Controllers\UserController' not found；前者大概率是路由未注册，后者一定是命名空间或文件路径错误。
