laravel 9 废弃了字符串形式的控制器路由语法（如 `’admintoolscontroller@php‘`），必须改用数组语法并显式引入控制器类，否则会报 “target class does not exist” 错误。

在 Laravel 9 中，控制器路由不再支持旧版的字符串式写法（如 ‘AdminToolsController@php’）。这是自 Laravel 8.2 起逐步推行、并在 Laravel 9 中全面强制执行的变更——其核心目的是提升类型安全、IDE 支持和自动加载可靠性。若继续使用字符串语法，PHP 无法自动解析命名空间，导致 Illuminate/Contracts/Container/BindingResolutionException，提示类似 Target class [AdminToolsController] does not exist。

✅ 正确做法是：使用数组语法 [Controller::class, ‘method’]，并确保在路由文件中 use 引入完整命名空间。

以你的 AdminToolsController 为例，需按以下步骤修正：

1. 确认控制器位于标准命名空间下
   Laravel 9 默认控制器位于 app/Http/Controllers/ 目录，且应声明命名空间：

   // app/Http/Controllers/AdminToolsController.php
   
   

2. 在 routes/web.php 中正确注册路由
   ✅ 推荐方式（清晰、可读性强、支持 IDE 自动跳转）：

   use App/Http/Controllers/AdminToolsController;
   
   Route::get('/php', [AdminToolsController::class, 'php']);

   ✅ 或不引入、直接写全限定名（适合单次使用或避免命名冲突）：

   

   MuleRun

   全球首个AI Agent交易平台

   下载

   Route::get('/php', [/App/Http/Controllers/AdminToolsController::class, 'php']);

   ❌ 错误写法（Laravel 9 中已废弃且失效）：

   Route::get('/php', 'AdminToolsController@php'); // ⚠️ 报错：Target class does not exist

⚠️ 注意事项：

• 若控制器不在 App/Http/Controllers 下（例如自定义命名空间或放在 app/ 根目录），必须使用完整命名空间路径；
• 运行 composer dump-autoload 并非必需（Laravel 使用 PSR-4 自动加载），但若移动过控制器文件，可执行该命令确保类映射更新；
• 检查控制器是否继承 Illuminate/Routing/Controller 或 App/Http/Controllers/Controller（推荐后者，以便复用中间件、验证等基类功能）；
• 路由缓存（php artisan route:cache）会固化路由定义，修改后务必清除缓存：php artisan route:clear。

总结：Laravel 9 的路由控制器语法变更不是“bug”，而是框架向更现代、更健壮的依赖注入与静态分析方向演进的关键一步。坚持使用 use + [Class::class, 'method'] 模式，不仅能解决当前问题，还能为后续升级、测试和团队协作打下坚实基础。

https://www.php.cn/faq/1974037.html