直接删掉 composer.json 中重复的包声明项，再运行 composer update
这事儿其实挺常见的：composer.json 里同一个包不小心被声明了两次。直接删掉冗余项，然后跑一遍 composer update 就行。但关键点在于，千万别只改完 composer.json 就以为万事大吉。如果不同步更新 composer.lock 和 vendor 目录，依赖解析失败、锁文件异常或者自动加载冲突，几乎是必然的结果。整个过程，需要人工仔细确认，确保三处状态一致。
记住这个核心操作：直接删掉重复的包声明项，再跑 composer update。不要只改 composer.json 就扔着不管，否则 composer.lock 和 vendor/ 会不一致，报错是必然的。
怎么发现 composer.json 里有重复包
Composer 本身并不会主动校验重复声明，这是个盲区。但同一个包如果重复出现在 require 或 require-dev 里，后续的 composer update 命令就很可能报错，或者出现一些难以预料的行为，比如版本冲突，甚至锁文件写入失败。怎么判断中招了呢？通常有这几个迹象：
- 执行
composer update时，命令卡在解析依赖阶段，终端输出里可能会看到类似Package vendor/name is listed multiple times的警告。当然，有些 Composer 版本可能会静默覆盖其中一项，但这种行为并不可靠。 - 运行
composer show vendor/name查看某个包时，如果发现它显示了两个不同的版本号，那基本可以断定锁文件里已经存了歧义的记录。 - 最直接的方法：手动打开
composer.json文件，用编辑器的搜索功能查找包名。很容易发现同一行不小心写了两次，或者在不同位置重复声明了。这在合并分支、或者复制粘贴配置时尤其常见。
composer remove 不能解决重复声明问题
这里有个常见的误区：以为用 composer remove 命令就能搞定。其实不然。composer remove 只处理那些“已经安装并且被声明”的包，它不会去扫描并合并 composer.json 中的重复项。如果你执行 composer remove vendor/name，而这个包在文件里重复写了两行，命令通常只会删掉它找到的第一行，第二行就残留下来了。下次再跑 composer update，问题依旧。
- 所以，必须人工检查并手动删掉所有重复的条目，确保每个包名在
require和require-dev中最多只出现一次。 - 注意大小写问题：PHP 的包名是区分大小写的。虽然
monolog/monolog和Monolog/Monolog在 Composer 眼里是两个不同的包，但它们实际指向同一个东西，这同样会引起冲突。 - 也别太依赖 IDE 的自动补全功能——有些插件在你输入时会“好心”地自动添加一行，如果没留意，重复声明就这么悄悄产生了。
删完重复项后必须同步三处状态
只修改 composer.json 文件，可以说是最危险的操作。你必须让 composer.lock、vendor/ 目录以及自动加载器的状态同时对齐：
- 运行
composer update vendor/name（精准更新该包）或者composer update（全量更新）。通常推荐前者，速度更快，也更可控。 - 更新后，用
composer show vendor/name验证输出是否唯一，且版本号符合你的预期。 - 检查
vendor/composer/autoload_psr4.php这类自动加载文件，确认是否只有一组该包的命名空间映射。如果里面还有双份记录，说明composer.lock没刷新干净，可以尝试删除composer.lock文件后重新运行composer update。 - 在 CI 或 Docker 构建流程中，务必加上
--no-dev选项（针对生产环境），或者确认require-dev部分的重复项也已清空，否则composer install可能会拉取错误的包。
为什么有时候删了重复项还报 autoload 错误
这是因为 composer dump-autoload 命令默认不会自动清理旧的映射关系，尤其是在使用了 --classmap-authoritative 或 --optimize 优化选项的项目里。残留的 classmap 条目可能仍然指向已被删除的路径，从而导致 Class not found 错误。
- 强制重建自动加载映射：运行
composer dump-autoload -o --classmap-authoritative。 - 手动检查
vendor/composer/autoload_classmap.php文件，确认重复包对应的类路径已经消失。 - 某些框架（例如 Lara vel）会缓存自动加载信息，部署后需要清理应用缓存：
php artisan config:clear、php artisan cache:clear。 - 如果服务器启用了 OPCache，可能需要重启 PHP-FPM 服务，或者在代码中调用
opcache_reset()函数，否则旧的映射可能还留在内存里。
说到底，重复声明不是什么边缘情况，而是日常团队协作中最容易被忽略的“隐性污染”。它不会立刻让系统崩溃，但会让后续每一次的 composer update 都变得不可预测。真正麻烦的，从来不是删不掉，而是你以为删干净了，其实还留着半截影子在作祟。
