项目在 Windows 上开发,composer 2.7,autoload 里写 "App\\": "app/",本地一直正常。推到测试机,Ubuntu 22.04,一访问就报 Fatal error: Uncaught Error: Class "App\Service\UserService" not found。文件明明在 app/Service/UserService.php,命名空间也写的 App\Service。
第一件事是确认自动加载映射对不对。composer dump-autoload -o 之后会生成 vendor/composer/autoload_classmap.php,grep 一下 UserService 能搜到,说明类被扫到了。但 path 那一栏写的是 app/service/UserService.php,全小写,服务器上目录是 Service。ext4 区分大小写,Windows 和 macOS 默认文件系统不区分,本地永远不会报错。
改目录名还有一个坑:Windows 上 git 默认 core.ignorecase=true,把 Service 改成 service 再改回来,git 认为没变化,commit 里什么都没有。我这边是 git mv Service Service_tmp 再 mv 回去,两次提交,才把大小写变更推上去。
{
"autoload": {
"psr-4": {
"App\\": "app/"
}
}
}
命名空间和目录必须严格对齐。PSR-4 的规则是前缀映射之后,类名剩余部分按反斜杠逐段对应子目录,大小写原样保留。类名 UserService 对应文件名 UserService.php,一个字母都不能差。写成 Userservice.php 在本地能跑,上线就 500。
排查顺序我固定成三步:先 dump-autoload -o 看 classmap 里有没有这个类,再看 classmap 里的路径和实际文件大小写是否一致,最后看 composer.json 的 psr-4 前缀有没有多写或少写反斜杠。第二步用 find 加 grep 最快,别靠眼睛。
