命名空间重叠直接导致fatal error，而非警告或延迟报错；只要两个包在autoload中注册相同psr-4前缀（如均配"app": "src/"），require vendor/autoload.php后首次实例化该类即终止执行并报“cannot declare class xxx”。

命名空间重叠直接导致 Fatal error，不是警告也不是延迟报错

只要两个包在 autoload 中注册了相同 PSR-4 前缀（比如都配了 "App": "src/" 或更危险的 ""），require vendor/autoload.php 后第一次 new 那个类，PHP 就会终止执行，报 Fatal error: Cannot declare class Xxx。没有重试、不提示冲突来源、IDE 也跳转失败——它根本没机会走到调试阶段。

快速定位哪个包在偷偷覆盖命名空间

别翻 composer.json 手动比对，用 Composer 自带命令精准揪出：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 运行 composer dump-autoload -vvv | grep -A5 -B5 "App\"（把 App\ 换成你怀疑的命名空间），看最后出现的映射来自哪个包
• 查具体包：用 composer show vendor/package-name 看它的 autoload 字段；再用 grep -r '"App\\":' vendor/*/composer.json 扫描所有已安装包
• 临时验证：删掉 vendor/composer/autoload_psr4.php，只留 autoload_classmap.php，再跑一次。如果错误消失，说明纯属 PSR-4 前缀重叠，和 classmap 无关

修复必须改依赖包的 autoload，而不是主项目硬塞映射

主项目里加一条 "App": "vendor/myfork/src/" 是无效操作——它不会覆盖已有映射，反而可能让问题更难追踪。真正有效的动作是：

• 优先修改 fork 包或私有包的 composer.json："name" 必须唯一（如 "acme/monolog"），不能沿用原名
• 同步更新它的 autoload.psr-4，确保命名空间前缀与新 name 对应（如从 "Monolog": "src/" 改为 "AcmeMonolog": "src/"）
• 主项目中通过 repositories 指向你的新源，并在 require 里用新包名；若其他依赖间接拉入原包，需加 replace 声明替代关系
• 改完必须运行 composer dump-autoload --optimize，否则新映射不生效

PSR-4 映射末尾少反斜杠？文件路径就全错

"App": "src/" ✅ 和 "App": "src" ❌ 的区别不是风格问题，是路径拼接逻辑断裂点。后者会让 AppServicesUserService 被解析成 src/Services/UserService/UserService.php，多了一层目录。

• 检查 vendor/composer/autoload_psr4.php 输出，确认映射是否含结尾反斜杠
• 文件名必须与类名完全一致（含大小写）：UserService.php ✅，userservice.php ❌（Linux 下必报 Class not found）
• 多个 psr-4 配置段会覆盖而非合并——JSON 中重复写 "psr-4" 键，后一个会直接干掉前一个

最常被忽略的一点：改了包名和命名空间后，classmap 不会自动重建。如果你依赖 classmap 加载某些工具类，得手动加 --classmap-authoritative 或确保 exclude-from-classmap 没误删关键文件。