应先确认是否真需绕过：若锁文件版本过高，运行composer update --lock；若仅缺非必需扩展，用--ignore-platform-req=ext-name精准跳过；避免误用--ignore-platform-reqs导致运行时崩溃。
composer install 报 platform requirements mismatch 怎么办
直接原因是本地 PHP 版本或扩展（如 ext-mbstring）不满足 composer.json 或依赖包声明的 platform 要求。这不是锁文件损坏，也不是网络问题，而是 Composer 2.2+ 默认启用的平台校验在拦截。
别一上来就加 --ignore-platform-reqs——它会跳过全部检查，包括 ext-redis、lib-curl 这类运行时必需项，装完大概率报 Class 'Redis' not found。
- 先确认是否真要绕过：运行
php -v和php -m，比对报错里提到的版本/扩展是否确实缺失 - 若只是
composer.lock锁了高版本（比如锁着 PHP 8.2，你本地是 8.1），优先跑composer update --lock，它只重写 lock 文件结构，不升级包 - 若确定缺的是非核心扩展（如开发时不用图片处理，可暂缺
ext-gd），用精准跳过：composer install --ignore-platform-req=ext-gd - 拼写必须严格匹配
php -m输出，ext-curl不能写成curl或php-curl
为什么 --ignore-platform-reqs 不带等号就等于全忽略
命令行参数解析很敏感：--ignore-platform-reqs 是开关式参数，不接受值；而 --ignore-platform-req=php 是键值对式，只跳指定项。但如果你写成 --ignore-platform-req php（中间空格、无等号），Composer 会把它当成 --ignore-platform-reqs 处理。
这个细节导致很多人“以为只跳 PHP”，结果连 ext-zip 都没校验，后续 composer create-project 解压失败或 intervention/image 安装中断。
-
--ignore-platform-reqs→ 跳过所有平台项（PHP 版本、所有ext-*、所有lib-*） -
--ignore-platform-req=php→ 只跳 PHP 版本，保留扩展和系统库检查 -
--ignore-platform-req=ext-gd --ignore-platform-req=ext-igbinary→ 可叠加，大小写敏感，值必须完整 -
--ignore-platform-reqs=true→ 无效参数，命令直接退出
CI/CD 中 composer install 卡住，该信报错还是信日志
CI 日志里出现 platform requirements mismatch，说明是平台层问题；若出现 could not resolve packages 或 don't install symfony/console v6.0，那根本不是环境问题，是依赖树逻辑冲突，--ignore-platform-reqs 完全无效。
很多 CI 脚本盲目加 --ignore-platform-reqs，结果发现 PHP 版本低导致某些包源不可用（如 Laravel 11 拒绝在 PHP 8.1 下下载），或者 ext-zip 缺失让 composer create-project 在解压阶段失败——这些其实是平台问题；而真正卡住安装的，往往是 laravel/framework 和 symfony/console 的语义化版本互斥。
- 看第一行报错关键词：含
platform就查 PHP/扩展；含resolve、conflict、prohibits就用composer prohibits vendor/package定位冲突源 - CI 镜像 PHP 版本必须和
composer.json的"php": "^8.2"对齐，否则再怎么加 ignore 也下不了包 -
composer install在 CI 中应始终基于已提交的composer.lock，且该文件不能被.gitignore排除
删了 composer.lock 后还能用 install 吗
不能。此时 composer install 会直接报 Lock file does not contain required package 或拒绝执行——因为 install 的语义就是“按锁文件还原”，没锁文件，它不知道装什么。
想从头生成依赖树，必须用 composer update（或 composer update --lock 同步结构）。有人误以为删锁 + install 是“跳过版本检查”，其实只是误用了命令。
- 删
composer.lock后，正确操作是composer update，它会读composer.json，重新解析整个依赖图 - 若只想修复损坏的
vendor/，只删vendor/目录，保留composer.lock，再跑composer install - 手动编辑
composer.lock极其危险：JSON 格式错一个逗号，就会触发Invalid argument supplied for foreach()
最常被忽略的一点：平台检查和版本约束是两层独立机制。加 --ignore-platform-req=php 不会让 "monolog/monolog": "^2.0" 接受 v3.0；删 composer.lock 也不会让 ext-redis 突然存在。问题在哪一层，就得用对应层级的解法，混着来只会让错误更隐蔽。
