Class XXX is not autoloaded 通常因autoload配置未覆盖类路径，需检查vendor包composer.json的autoload段、命名空间与路径匹配性，或临时用classmap解决。
composer dump-autoload 时提示 Class XXX is not autoloaded
这通常不是真正的冲突，而是 autoload 配置未覆盖到某个类路径。Composer 在生成 vendor/autoload.php 时，只按 composer.json 中的 autoload 和 autoload-dev 规则扫描声明路径；如果某包把类放在非标准位置（比如 src/ 外的 lib/ 或根目录），又没在自己的 composer.json 里显式声明，就会被跳过。
检查方法：
- 进入对应 vendor 包目录（如
vendor/acme/sdk），看它自己的composer.json里是否有autoload段，重点看psr-4映射是否漏掉子命名空间或路径拼写错误（比如写成"Acme\": "src/"却把类放在src/Utils/Helper.php，而命名空间是AcmeTools） - 运行
composer show acme/sdk确认安装版本，再查该版本 tag 下的composer.json原文（别信本地修改过的） - 临时加一条
classmap到你项目根composer.json中，指向缺失类所在目录，再跑composer dump-autoload -o测试是否解决
多个包声明了同一个命名空间前缀
这是真冲突：A 包和 B 包都在各自 composer.json 中写了 "MyLib\": "src/"，但 Composer 只会加载最后注册的那个（按 installed.json 顺序），前面的被静默覆盖。
定位方式：
- 执行
composer dump-autoload -v，观察输出中Adding classmap directory...和Adding PSR-4 autoloading...的顺序，找到重复前缀的包 - 用
grep -r "MyLib\\.*src" vendor/*/composer.json快速筛出所有声明该前缀的包 - 打开
vendor/composer/autoload_psr4.php，直接查看最终注册结果——同一键名只保留最后一个值
注意：psr-4 冲突不会报错，但运行时可能加载到旧版类、方法不存在、类型不匹配，问题延迟暴露。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
require-dev 包的类意外进入生产 autoload
如果你执行的是 composer install --no-dev，但某些 dev-only 包仍出现在 vendor/autoload.php 的加载链里，说明它们被其他正式依赖间接 require 了，或者你的 autoload-dev 被误写进了主 autoload。
排查要点：
- 检查项目根
composer.json，确认autoload-dev是独立字段，没和autoload合并或缩进错误 - 运行
composer depends --tree vendor/package-name查哪个正式依赖拉入了该 dev 包（常见于测试工具被当成 runtime 依赖） - 查看
vendor/composer/autoload_files.php，里面列出的是全局 require 文件——如果有 dev 包的引导文件在此，说明它被硬编码加载了
autoload_classmap.php 里出现重复文件路径
当多个包通过 classmap 方式注册了同一物理文件（比如都映射了 vendor/foo/bar/Helper.php），Composer 会在生成 autoload_classmap.php 时去重，但仅按路径字符串匹配。如果路径大小写不一致（Helper.php vs helper.php）或含符号链接，就可能漏判，导致运行时报 Cannot declare class: already declared。
实操建议：
- 用
find vendor -name "*.php" | xargs -I{} sh -c 'echo $(realpath {}); echo $(basename {})'找出真实路径重复的文件 - 禁止在多个包中对同一工具类做 classmap 声明；统一收归到一个基础包，其余包通过
require依赖它 - 升级 Composer 到 2.5+，新版对 classmap 冲突增加了更明确的 warning 输出（但默认仍不中断）
vendor 目录的 autoload 冲突往往藏得深，因为 Composer 默认静默处理大多数异常注册。最有效的验证方式，永远是删掉 vendor/autoload.php 和 vendor/composer/autoload_*.php，再重新 dump-autoload 并检查生成结果——而不是只看命令是否成功返回。
