composer autoload冲突主因是路径、命名空间、缓存三者之一出错：psr-4映射不严格匹配、vendor/autoload.php引入错误或残留旧autoload文件。
Composer autoload 冲突几乎总是路径、命名空间、缓存三者之一出错，而不是 Composer 本身坏了。 类找不到、重复定义、本地能跑线上崩——这些问题背后基本逃不开 PSR-4 映射没对上、vendor/autoload.php 被错位 require、或 autoload_*.php 文件残留旧规则。
PSR-4 命名空间与文件路径不严格匹配
Composer 不做容错，它按字面拼接：你写 "App\": "src/"，它就去找 src/Services/UserService.php 里是否声明了 namespace AppServices;。差一个反斜杠、少一级目录、大小写不一致（尤其 Linux 生产环境），类就“消失”。
- 检查
composer.json中 PSR-4 前缀末尾是否有反斜杠（如"App\"，不是"App"） - 确认 PHP 文件里的
namespace声明与前缀 + 子路径完全一致，例如AppServicesUserService→ 对应路径必须是src/Services/UserService.php，不能是src/services/userservice.php - 用
ls -l src/Services/确认文件名大小写真实存在，别信 IDE 的“忽略大小写显示” - 打开
vendor/composer/autoload_psr4.php，搜索你的命名空间前缀，看对应路径是否为$baseDir . '/src/'这类动态拼接值
vendor/autoload.php 被错误引入或路径失效
ThinkPHP 5.1/6、Laravel 入口文件都靠手动 require 它启动自动加载。这行代码一旦写错位置、路径偏差或被条件包裹，整个 autoload 就形同虚设。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 入口文件（如
public/index.php）第一行必须是require __DIR__ . '/../vendor/autoload.php';—— 注意..层级和斜杠方向，Windows 也必须用正斜杠 - 执行
php -r "var_dump(file_exists(__DIR__ . '/../vendor/autoload.php'));"验证路径是否真能访问到文件 - 多个项目共用
vendor目录（比如设了COMPOSER_VENDOR_DIR环境变量）会导致autoload.php里硬编码的__DIR__指向错误根目录，必须删除该环境变量并逐项目重装 - 不要在中间件、控制器里补
require—— 加载时机已过，无效
dump-autoload 没真正生效或被缓存掩盖
改完 composer.json 后只执行 composer dump-autoload 是不够的；不加 -o 不会重建 classmap，不清理旧文件则可能继续走错映射。
- 每次修改 autoload 配置后，必须运行
composer dump-autoload -o（-o强制生成优化映射，能暴露路径拼写错误） - 若仍不生效，直接删掉
vendor/composer/autoload_*.php全部文件（保留installed.json），再跑一次composer dump-autoload -o - 部署后报错？可能是 OPCache 缓存了旧的 opcode，PHP 根本没读新生成的 autoload 文件 —— 清 OPCache 或重启 PHP-FPM
- 新增了
autoload-dev下的类（如测试类、Factory），必须加--dev：composer dump-autoload --dev -o
PSR-4 和 classmap 混用导致类“两头不靠”
同一类名被两种规则同时覆盖时，Composer 行为未定义；更常见的是你以为配了 PSR-4，其实文件没声明 namespace，结果既不进 PSR-4 流程，classmap 又没显式包含它。
- PSR-4 是命名空间驱动：只看
namespace声明 + 目录结构，不关心文件名是否含类名 - classmap 是路径驱动：直接把类名映射到具体文件路径，适合无 namespace 的老代码或纯函数文件
- 避免在 PSR-4 已覆盖的目录下又用 classmap 单独加某个文件（如
"lib/Utils.php"），容易冲突 - 确认
vendor/composer/autoload_classmap.php里没有和 PSR-4 规则重复的类名条目
最易被忽略的点：autoload 错误往往不是“没配置”，而是“配置了但没验证路径是否真实存在”“改了但没清缓存”“本地开发不区分大小写，上线就崩”。别猜，直接查 autoload_psr4.php 里的映射内容、用 file_exists() 测路径、删掉 autoload_*.php 强制重建——这些动作比反复 dump-autoload 更接近真相。
