--ignore-platform-reqs仅跳过PHP版本/扩展检查，不解决依赖版本冲突；真正报错源于锁文件不匹配或依赖树不可解，需删lock重装或用prohibits定位阻塞源。
--ignore-platform-reqs 对版本报错完全无效——它只跳过 PHP 版本、扩展等平台检查，不碰任何依赖版本逻辑。真正卡住安装的“版本报错”，几乎都属于两类：锁文件冲突或依赖树不可解。得先分清错误类型，再选路径。
看到 “Your lock file does not contain a compatible set of packages” 怎么办
这是 composer.json 里的依赖声明（比如 "monolog/monolog": "^3.0"）和现有 composer.lock 记录的版本不匹配，Composer 拒绝“睁眼装”。
-
--ignore-platform-reqs在这里毫无作用，别试 - 最干净的做法：删掉
composer.lock，再跑composer install，让 Composer 全量重解依赖树 - 想保留当前已装包的版本？用
composer update --lock，它只更新 lock 文件结构，不改任何包版本 - CI/CD 中务必确保
composer.lock已提交且未被.gitignore，否则每次构建都可能装出不同结果
执行 composer require xxx:1.2.3 报 “don’t install xxx 1.2.3”
说明依赖图里已有包（比如 laravel/framework）及其约束（如 "^10.0"）直接拦住了这个版本。
- 先查阻塞源：
composer prohibits xxx:1.2.3，输出会明确指出谁在拦你 - 推荐做法：调整冲突包版本，或用
composer require xxx:1.2.3 --no-update先写入composer.json，再跑composer update xxx --with-all-dependencies触发深度回溯求解 - 极端情况可临时注释其他
require条目，单独装完再补——但易漏依赖，风险高
为什么改了 config.platform.php 还是报错
在 composer.json 里加 "platform": {"php": "8.1.28"} 是“假装环境”，但它有隐性前提：
- Composer 版本太老（如 2.2.x）可能无法正确生成 autoload 映射，导致运行时报
Class not found - 版本号必须完整，
"php": "8.1"会被解析失败，得写成"php": "8.1.28" - 这个设置只影响依赖解析阶段，不解决运行时语法兼容问题（比如用了 PHP 8.2 的
match表达式，却在 PHP 7.4 上跑）
真正容易被忽略的点
很多人以为加个 --ignore-platform-reqs 就万事大吉，但运行时工具（如 phpunit、larastan）自己也会校验 PHP 版本或扩展——它们启动时仍可能直接退出，和 Composer 安装阶段无关。更麻烦的是 Docker 多阶段构建：builder 镜像用 --ignore-platform-reqs 装上了包，runtime 镜像却没装对应扩展，部署后一调就崩。
