Class位于...不遵守psr-4规范,因命名空间与文件路径不匹配。例如composer.json配置"App\\": "app/"时,类App\Models\Post必须位于app/Models/Post.php。若目录写成Model而非Models则报错。PSR-4大小写敏感,文件名如UserController.php不可小写。修改后需运行composer dump-autoload更新自动加载映射。同时检查composer.json中psr-4配置是否正确,如反斜杠数量和路径拼写。确保命名空间、文件路径、文件名三者一致即可解决。

这个提示是因为 Composer 的 PSR-4 自动加载规范要求类文件的命名和目录结构必须严格匹配命名空间。出现 "Class ... located in ... does not comply with psr-4..." 错误,说明某个类的实际路径与它的命名空间不一致。
检查命名空间是否正确
确保类文件中的命名空间和它在项目中的实际目录结构完全对应。例如:
假设你的composer.json 中配置了:
"autoload": {
"psr-4": {
"App\\": "app/"
}
}
那么:
- 类
App\User必须位于app/User.php - 类
App\Models\Post必须位于app/Models/Post.php
如果 Post 类写的是 namespace App\Models;,但文件放在了 app/Model/Post.php(注意是 Model 而不是 Models),就会报错。
确认文件后缀和大小写
PSR-4 对大小写敏感,尤其是在 Linux 系统或 Docker 环境中:
- 类名
UserController对应文件名必须是UserController.php,不能是usercontroller.php - 目录名也要匹配命名空间,比如
Controllers不能写成controllers
重新生成自动加载映射
修改完命名空间或文件位置后,运行以下命令刷新自动加载文件:
composer dump-autoload
或者加上优化参数:
composer dump-autoload -o
这会重新解析 psr-4 配置并生成新的类映射。
验证 composer.json 配置
检查 composer.json 中的 autoload.psr-4 是否正确。常见错误包括:
- 缺少反斜杠结尾:应写为
"App\\": "app/",而不是"App": "app/" - 路径拼写错误,如
appp/或src写成source
基本上就这些。只要命名空间、文件路径、文件名三者一致,并且配置正确,问题就能解决。不复杂但容易忽略细节。










