Composer别名仅解决版本约束映射，不处理autoload冲突；autoload冲突需通过修正PSR-4配置、消除命名空间重复声明或路径重叠来修复。
Composer 别名不解决 autoload 冲突
别名（alias）在 Composer 中仅用于版本约束映射，不是命名空间或自动加载路径的重定向机制。你无法用 "monolog/monolog": "2.10.0 as 2.9.0" 这类 alias 来绕过 PSR-4 自动加载冲突——它只影响依赖解析阶段的版本“认知”，不改变类文件实际加载位置或命名空间绑定逻辑。
autoload 冲突的本质是：两个包注册了相同命名空间（如 GuzzleHttp），或同一命名空间被多个 psr-4 规则指向不同目录，导致 Composer Autoloader 加载时覆盖或报错。
所以，别名不是解药；真正要动的是 autoload 配置和依赖结构。
autoload 冲突的典型表现与定位
运行 composer dump-autoload -v 或启动项目时出现以下任一现象，基本可判定为 autoload 冲突：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
Class XXX already exists（类重复定义） -
Class YYY not found，但文件存在、命名空间也对，只是没被加载 -
Cannot use XXX because the name is already in use（PHP 命名空间层面冲突）
快速定位方法：
- 检查
vendor/composer/autoload_psr4.php，搜索冲突的命名空间前缀，看是否有多条映射 - 运行
composer show --platform确认 PHP 版本和扩展兼容性，避免因环境不匹配导致 autoloader 初始化失败 - 执行
composer dump-autoload --optimize后仍报错？说明问题不在缓存，而在配置本身
真正有效的 autoload 冲突修复方式
核心原则：一个命名空间只能由一个 psr-4（或 psr-0/classmap）规则声明，且路径必须唯一、无重叠。
- 删掉重复的
autoload声明：比如你手动在composer.json里加了"App\": "app/"，又通过第三方包引入了同名规则，必须保留其一 - 避免
psr-4路径交叉：例如"App\": "src/"和"App\Helper\": "app/Helper/"是危险的——后者会被前者覆盖，因为App前缀更长匹配优先级更高 - 自定义目录必须显式声明：ThinkPHP 的
app/library/或 Laravel 的app/Support/，若未在autoload.ps4中列出，就不会进自动加载器 - 清理残留：删除
vendor/composer/autoload_*.php手动文件后，再运行composer dump-autoload，避免旧映射干扰
当命名空间真撞车了怎么办
比如两个私有包都用了 MyCompany，但你不能改对方代码。此时别名无用，得换思路：
- 用
replace+provide声明虚拟包：把其中一个包“假装”成另一个的兼容实现，让 Composer 认为它们不冲突（适用于接口契约一致的场景） - 封装隔离：将冲突包打包进独立插件，用
autoload-dev或运行时require_once加载，避开主 autoloader - 改命名空间（最后手段）：用
sed或工具批量替换源码中的namespace MyCompany→namespace MyCompanyV2，再配对应psr-4
最常被忽略的一点：autoload 冲突往往藏在 require-dev 里——某个开发依赖偷偷注册了和生产包一样的命名空间，却只在 composer install --no-dev 时消失，排查时务必注意环境开关。
