如何解决 Composer 和 PHPUnit 版本之间的兼容性冲突？

Composer 与 PHPUnit 版本冲突源于 PHP 环境、Composer 依赖约束和 PHPUnit 版本三者未对齐；需先确认 php -v 和 composer --version，修正 platform 配置，按 PHP 版本选用对应 PHPUnit 主版本（如 PHP 8.2–8.3 用 ^10.5），清理 lock 和 vendor 后明确声明 require-dev 并 install，必要时用 composer why-not 定位并升级关联依赖。

Composer 和 PHPUnit 的版本冲突，本质是项目依赖的 PHP 版本、PHPUnit 版本与 Composer 解析出的依赖图不匹配。解决的关键不是强行降级或跳过检查，而是让三者对齐：PHP 运行环境 → Composer 的 require 约束 → PHPUnit 的实际安装版本。

确认当前 PHP 和 Composer 环境

先明确底层约束，避免后续操作无效：

• 运行 php -v 查看实际 PHP 版本（例如 8.2.10）
• 运行 composer --version 确保是较新稳定版（建议 ≥ 2.5），旧版 Composer 对 PHP 8.2+ 或新版包支持不佳
• 检查 composer.json 中的 "platform" 配置，它会覆盖真实 PHP 版本用于依赖解析，如有误配需修正或删除

按 PHP 版本选对 PHPUnit 主版本

PHPUnit 官方严格按 PHP 版本分发主版本，不能跨代混用：

• PHP 8.2–8.3 → 推荐 phpunit/phpunit:^10.5（最低要求 PHP 8.1）
• PHP 8.1 → 可用 ^9.6 或 ^10.0，但 ^10.5 更稳妥
• PHP 7.4–8.0 → 必须用 ^9.5，^10.x 已不支持
• 不要写 "phpunit/phpunit": "*" 或宽泛的 ^9.0 || ^10.0，Composer 无法自动选最适版本

清理缓存并重装依赖

旧锁文件和本地缓存常导致 Composer 误复用不兼容版本：

标签： php js json composer