线上 500 本地正常:composer autoload 类名大小写怎么查

新加的一个订单同步服务,本地 Windows 环境跑得好好的,合并上线后接口直接 500。error_log 里只有一句 Class "App\Service\OrderSYNc" not found,堆栈停在容器的解析那一步。

文件在 app/Service/ 下面,名字是 ordersync.php,类名写的是 OrderSync,命名空间没写错。PSR-4 的加载规则是按命名空间拼路径再 include,拼出来的路径是 app/Service/OrderSync.php,Linux 上大小写敏感,文件实际叫 ordersync.php,include 失败,类就找不到了。本地 NTFS 不区分大小写,同样的路径能打开,所以开发环境永远复现不出来。

先试了 composer dump-autoload -o 生成优化后的 classmap。classmap 是扫描文件内容把类名和真实路径记下来,不依赖文件名拼路径,问题当场消失。但这只是把坑盖住,下次新加类如果还是文件名和类名不一致,换个没开 -o 的环境照样炸。

确认了线上之前一直没开优化,composer.json 里没有 config.optimize-autoloader,部署脚本只跑 dump-autoload。

php -r "var_dump(class_exists(
  'App\Service\OrderSync'));"
composer dump-autoload -o
grep -n "OrderSync" vendor/composer/autoload_classmap.php

最终改法是 git mv ordersync.php OrderSync.php。Windows 上 git 默认 core.ignorecase=true,只改大小写的重命名不会进暂存区,得先 git config core.ignorecase false 再 mv,提交记录里能看到 rename。

验证分两步:本地清空 vendor 重新 install,php -r 里 class_exists 返回 true;线上发布后同样的命令再跑一遍,然后请求一次同步接口,返回 200 且写入了两条测试数据。

顺手在 CI 里加了一步检查,用 find 找出 app 目录下文件名首字母小写的 PHP 文件,命中就报错。这个规则上线后拦下了三个同类问题。

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