Composer升级后项目跑不通，主因是autoload逻辑变更：2.2+默认启用platform-check、autoloader-suffix和prepend-autoloader，废弃--optimize，且更严格校验psr-4命名空间结尾反斜杠、路径大小写及classmap目录存在性；需清vendor与composer.lock后重装并验证autoload文件生成数量。
Composer 升级后项目跑不通，大概率不是你的代码坏了，而是 Composer 自身行为变了——尤其是 autoload 生成逻辑、vendor/autoload.php 加载顺序、以及对 psr-4 / classmap 的解析更严格了。
看懂 CHANGELOG.md 里真正影响你的条目
别从头扫到尾。直接搜这些关键词：autoload、psr-4、classmap、dump-autoload、vendor-dir、platform-check。Composer 2.2+ 开始默认启用 platform-check，会校验 PHP 扩展是否真实可用（比如你 composer.json 声明了 "ext-gd": "*"，但 CLI 下没装 gd 扩展，composer install 就会失败）。
- Composer 2.0 起废弃了
composer.lock中的packages-dev字段，改用packages统一管理，但 dev-only 包只在--dev模式下加载 —— 如果你手动 requirevendor/autoload.php时没传['dev' => true]（某些测试启动脚本会这么干），类就找不到 - Composer 2.2+ 默认开启
autoloader-suffix，生成的vendor/composer/autoload_*.php文件名带哈希，旧缓存或硬编码路径会失效 -
composer dump-autoload --optimize在 2.2+ 中已完全移除，改用--apcu或保持默认即可；继续用会报错Unknown option: optimize
快速验证是不是 autoloader 问题
运行 composer dump-autoload -v，重点看最后几行输出：
Generated autoload files containing XXX classes
如果数字远小于你预期（比如只有几十个，而你项目有上千个类），说明部分 psr-4 映射没被识别。常见原因：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer.json里psr-4的 namespace 结尾没加反斜杠（"App\": "src/"✅，"App": "src/"❌） -
"src/"目录下没有App/子目录，或大小写不一致（Linux 下app/≠App/） - 用了
classmap但路径指向了空目录，新版本会跳过而非静默忽略
临时加一句 die(var_dump(get_included_files())); 到入口文件开头，确认加载的 autoloader 是不是最新生成的那一个（路径含 autoload_static.php 或 autoload_classmap.php）。
vendor/autoload.php 不再“兜底”所有情况
旧版 Composer 允许你在 vendor/autoload.php 之后再 require 其他 autoloader，新版更倾向“一次性加载完毕”。如果你项目里有类似这样的结构：
require __DIR__.'/vendor/autoload.php'; require __DIR__.'/app/helpers.php'; // 里面定义了函数，但没命名空间
问题可能出在：Composer 2.2+ 默认启用 prepend-autoloader，把它的 autoloader 插入到 spl_autoload_functions() 最前面，而某些第三方库（如 old Symfony components）依赖自己的 autoloader 在前，结果函数找不到。
- 临时解决：在
composer.json加"config": {"prepend-autoloader": false}，再composer dump-autoload - 长期建议：把
helpers.php改成psr-4映射，或用files字段声明（"files": ["app/helpers.php"]） - 注意：Laravel 9+ 和 Symfony 6+ 已适配新行为，但私有封装的 legacy 包很可能没跟上
最常被忽略的是：升级 Composer 后没清掉旧的 vendor/composer/autoload_*.php 缓存文件，或者 CI 环境里多个 Composer 版本混用导致 lock 文件生成逻辑不一致。动手前先 rm -rf vendor composer.lock，再 composer install —— 不要跳这步。
