composer 2.7 dump-autoload 后类找不到 PSR-4 命名空间怎么改

现象

项目新增 app/ServiCes/PdfMaker.php,命名空间写的是 App\Services,执行 composer dump-autoload 后接口仍报 Class "App\Services\PdfMaker" not found。文件存在,本地 Windows 正常,传到 Linux 服务器就复现。

原因

Composer 按 composer.json 里的 PSR-4 前缀去拼路径,前缀和目录必须逐字符对应。Windows 文件系统不区分大小写,App 和 app 都能打开;Linux 区分大小写,目录或文件名差一个字母就会加载失败。另外 autoload 未更新、OPcache 缓存旧 classmap,也会让新类加不进来。

解决步骤

第一步,核对映射和真实路径。看 composer.json 里的 autoload 段,确认前缀与目录的相对位置一致,再用 ls 检查目录和文件名的大小写。

grep -A6 '"autoload"' composer.json
ls -R app | head -20
composer dump-autoload -o

第二步,用命令行验证加载。引入 autoload 后直接判断类是否存在,同时打印 class_exists 的结果和文件路径,避免被框架缓存干扰。

php -r "require 'vendor/autoload.php';
var_dump(class_exists('App\Services\PdfMaker'));"

第三步,清理缓存并统一命名。把目录和文件名改成与命名空间完全一致,重新生成优化后的 autoload,再清一次 OPcache 或重载 FPM。部署脚本固定执行 dump-autoload,不要依赖提交 vendor 目录。

验证

class_exists 返回 true,接口调用不再报 not found,psr-4 映射文件里能看到 App\Services 指向 app/Services,说明自动加载已生效。

小结

类找不到先查 PSR-4 的大小写和路径,再查 autoload 是否重新生成。跨平台开发时,目录名按命名空间原样创建最省事。

您可以还会对下面的文章感兴趣: