Laravel 4 出现 Target class [PostsController] does not exist 报错如何解决

DevOps 小满

2026-10-7

问题根因

该报错常见于 Laravel 8 及更高版本，核心原因是 Laravel 8 开始默认取消了路由服务提供者中预设的控制器命名空间前缀：

Illuminate\Contracts\Container\BindingResolutionException
Target class [PostsController] does not exist

Laravel 7 及更早版本的 RouteServiceProvider 中默认定义了 $namespace = 'App\Http\Controllers' 属性，路由配置中写字符串格式的控制器名时会自动拼接该前缀；8 版本之后该属性被默认注释，直接写 'PostsController@index' 无法匹配到完整命名空间下的控制器类。

额外注意：请确认控制器文件名为 PostsController.php，存放在 app/Http/Controllers 目录下，文件名大小写与类名完全匹配，避免 Linux 系统大小写敏感导致的同类报错。

修复方案

以下三种方案任选其一即可：

方案一（官方推荐）：使用类名语法定义路由
首先在 routes/web.php 顶部引入对应控制器：
```
use App\Http\Controllers\PostsController;
```
再将路由配置修改为数组格式：
```
Route::get('/posts', [PostsController::class, 'index']);
```
方案二：字符串写法补全完整命名空间
无需额外引入，直接修改路由配置为：
```
Route::get('/posts', 'App\Http\Controllers\PostsController@index');
```
方案三（适配低版本升级场景）：恢复旧版自动前缀规则
打开 app/Providers/RouteServiceProvider.php，给类添加属性：
```
protected $namespace = 'App\Http\Controllers';
```
或者在 boot 方法的 web 路由组注册处添加命名空间配置，修改后原有字符串格式的路由写法即可正常生效。