composer.lock中platform字段与本地php版本不一致是最常被忽略的隐性冲突源，需用composer update --lock重算依赖树，而非手动修改或删除lock文件。
composer.lock 里 platform 字段和本地 PHP 版本对不上
这是最常被忽略的隐性冲突源。composer.lock 顶部的 platform 字段（如 "php": "8.1.25"）是 Composer 在生成锁文件时“假设”的运行环境，它会直接影响依赖解析结果——哪怕你本地是 PHP 8.2，只要 lock 文件里写的是 8.1，Composer 就按 8.1 的兼容性去选包。
检查方法：
head -n 20 composer.lock | grep -A5 platform再对比
php -v 输出。不一致时，运行 composer update --lock 让当前 PHP 环境重算一次依赖树，而不是直接删 lock 文件。
- 别手动改
composer.lock里的platform字段——它只是快照，不是配置项 - 如果项目要求锁定 PHP 版本（如 CI 环境），应在
composer.json的config.platform.php中显式声明，而非依赖 lock 文件 - PHP 扩展缺失也会触发类似问题：比如 lock 文件里有
ext-intl，但本地没启用，composer install不报错，但运行时报Class not found
git diff composer.lock 显示大量无关包变动
说明上次 composer update 没加 --with-dependencies 或用了全量更新，导致 lock 文件混入了非目标包的版本漂移。这种“污染”会让后续升级难以预测，尤其在团队协作中容易引发重复冲突。
典型表现：你只改了 laravel/framework，但 monolog/monolog、guzzlehttp/guzzle 也跟着变了版本，且新版本可能引入不兼容变更。
- 升级框架或核心包时，必须用
composer update laravel/framework --with-dependencies - 执行后立刻
git diff composer.lock，确认改动范围是否仅限于该包及其直系依赖（如illuminate/*、symfony/*） - 如果发现意外变动，回退 commit，再加
--dry-run验证：例如composer update laravel/framework --with-dependencies --dry-run
composer install 报错 “Your requirements could not be resolved” 但 lock 文件存在
这不是 lock 文件“坏了”，而是它和当前环境不匹配：可能是 PHP 版本升了、扩展装了、或者镜像源切到了 HTTP（v2 默认禁用）。Composer v2 会严格校验 platform + require-dev + 实际扩展三者一致性，v1 则可能悄悄绕过。
排查优先级：先跑 composer update --dry-run -v，翻到最后 10 行看冲突枢纽；再用 composer why-not 定向验证，例如报错里出现 don't install symfony/console:6.4.0，就立即执行 composer why-not symfony/console:6.4.0。
-
composer why-not输出为空？大概率是require-dev里的工具链（如phpunit/phpunit）拖着旧版sebastian/exporter，间接锁死symfony/console - 加
--no-dev快速验证：如果composer update --no-dev成功，说明冲突源在开发依赖里 - 别删
composer.lock后直接install——那等于放弃锁定，下次 CI 可能拉到完全不同的版本组合
vendor/ 和 composer.lock 里记录的版本不一致
常见于手动删过 vendor/ 但没清 composer.lock，或用 cp -r 复制了别人 vendor 目录。此时 composer install 会跳过安装（因 lock 文件已存在），但实际代码和 lock 记录对不上，运行时极易出错。
验证方式：composer show --tree | head -20 对比 composer.lock 里对应包的 version 字段。若发现差异，说明 vendor 已被污染。
- 强制同步：删掉
vendor/和composer.lock，再composer install（仅限本地调试，勿提交空 lock） - 安全做法：保留
composer.lock，运行composer install --no-scripts --no-plugins强制重装 vendor，避免脚本干扰 -
composer show --tree里看到某行末尾标着(locked to 3.2.1)，说明该版本由 lock 文件硬性指定，不受composer.json当前约束影响
git diff composer.lock，比事后花两小时查 why-not 更省事。
