类重复定义源于classmap扫描交叉导致同一文件被多次收录——两个classmap条目同时映射相同类名，生成重复autoload_classmap.php条目，php第二次加载时抛出fatal error。
类重复定义（Fatal error: Cannot declare class）基本可以确定是 classmap 目录扫描交叉导致的 —— 不是 PSR-4 冲突，也不是加载顺序问题，而是两个 classmap 条目同时包含了同一个 .php 文件，最终在 autoload_classmap.php 里生成了两条相同类名的映射。
为什么 classmap 会悄悄扫到同一文件两次
classmap 不按命名空间区分，只按文件路径递归扫描。一旦两个配置项指向有重叠的目录，或一个目录被多次声明，就极易重复收录：
-
"lib/"和"lib/utils/"同时出现在 classmap 数组里 →lib/utils/Helper.php被扫两次 -
"src/"和"./src/"看似一样，但 Composer 把./src/当作不同路径处理，可能都生效（尤其在某些 shell 环境下） - 主项目和某个 dev-only 包（如测试工具）都声明了
"tests/fixtures/"→ 同一MockService.php被两个包各自扫进 classmap - 使用 glob 模式时写成
"legacy/*.php"和"legacy/DB_*.php"，后者被前者完全覆盖，但 Composer 仍会分别扫描并登记
怎么快速定位重复扫描的源头
别翻 composer.json，直接看生成结果和 dump 日志：
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 打开
vendor/composer/autoload_classmap.php，搜索报错的类名（如Helper），看它是否对应多个路径（例如出现两次"Helper" => __DIR__ . "/../lib/Helper.php"） - 运行
composer dump-autoload -v，注意输出中是否有类似Scanning /path/to/lib/和Scanning /path/to/lib/utils/连续出现 - 重点检查
composer.json中的autoload.classmap和autoload-dev.classmap—— 后者常被忽略，但它在dump-autoload时默认也会参与扫描 - 执行
grep -r '"Helper"' vendor/*/composer.json，确认是否多个包在 classmap 里声明了含该类的路径
修复时必须改对位置，否则白干
classmap 重复不是“删一个就行”，得确保修改后不再触发二次扫描：
- 删除冗余条目：保留最精确的那个（如用
"lib/utils/Helper.php"就别再加"lib/"） - 避免相对路径歧义：统一用
"lib/"，绝不用"./lib/"或"/full/path/lib/" - dev-only 的 classmap 必须显式排除：在
composer.json中把测试用的路径挪到autoload-dev.classmap，然后运行composer dump-autoload --no-dev生产环境映射 - 改完立刻删旧文件：
rm vendor/composer/autoload_classmap.php，再跑composer dump-autoload -v验证输出中该类只出现一次
classmap 重复比 PSR-4 冲突更难察觉
PSR-4 前缀撞车至少会报 Ambiguous class resolution（加 -v 才见），而 classmap 重复完全静默 —— 它只会在 autoload_classmap.php 里写两行一样的键值对，PHP 加载时第二次 include 同一文件才爆 Cannot declare class。你看到错误时，冲突早已固化在映射文件里，不手动清理就一直存在。
