应通过 composer.json 的 config.platform 显式声明目标环境 PHP 和扩展版本（如 "php": "8.1.25"），并用 composer update --lock 在匹配环境中更新 lock 文件，而非手动修改 composer.lock。
直接改 composer.lock 里的 platform 字段没用，Composer 会在下次 install 或 update 时自动覆盖它——这个字段是生成的，不是配置项。
为什么 composer.lock 里会出现不同平台版本？
当你在本地（比如 macOS + PHP 8.2）运行 composer update，而生产环境是 Linux + PHP 8.1，composer.lock 中的 platform 会记录你本地的 PHP 和扩展版本。这会导致 composer install 在生产环境报错：Your lock file does not contain a compatible set of packages，因为 Composer 检测到当前平台与 lock 文件中声明的不一致。
根本原因：Composer 默认把当前运行环境的 php 和扩展版本写进 lock 文件的 platform 区块，用于约束依赖解析结果。
正确做法：用 config.platform 锁定目标环境平台
不要手动编辑 composer.lock，而是在 composer.json 中显式声明你要部署的目标平台。Composer 会据此生成兼容的 lock 文件。
-
config.platform.php必须设为生产环境的真实 PHP 版本（如"8.1.25"），不能写"8.1"—— Composer 不支持模糊版本 - 若生产环境缺某些扩展（如
ext-redis），但依赖包又声明了它，可加"ext-redis": "0"来“假装存在”，避免安装失败（仅限确实不需要该扩展功能的场景） - 设置后必须重新运行
composer update --lock（或composer update --dry-run确认无变更后再执行），否则composer.lock不会更新platform字段
{
"config": {
"platform": {
"php": "8.1.25",
"ext-redis": "0",
"ext-gd": "0"
}
}
}
CI/CD 部署时如何避免平台误判？
CI 流水线如果用高版本 PHP 构建 lock 文件，但部署到低版本环境，照样会出问题。关键不是“在哪跑 composer install”，而是“用什么平台信息生成 lock 文件”。
- 禁止在 CI 中运行
composer update（除非明确要更新依赖）；日常部署只用composer install --no-dev --prefer-dist - 确保 CI 使用和生产一致的 PHP 版本执行
composer update --lock（比如用php:8.1-cli镜像），否则platform仍会写入错误版本 - 检查 CI 日志里是否出现
Warning: You have configured the platform to be ... but your local PHP version is ...—— 这说明config.platform和实际运行环境冲突，需修正镜像或配置
常见误操作和后果
有人删掉 composer.lock 里的 platform 块、或把它清空，以为能绕过校验。结果是：Composer 会 fallback 到当前运行环境的 PHP 版本，反而让问题更隐蔽；下次别人在不同机器上 update，又带入新平台值，导致反复不一致。
真正需要关注的只有两点：一是 composer.json 中 config.platform 是否准确反映目标环境；二是所有生成 lock 文件的操作（尤其是 update）是否在匹配的 PHP 版本下执行。其余都是干扰项。
