报错“platform requirements mismatch”需用--ignore-platform-req精准跳过（如--ignore-platform-req=php），而“lock file不兼容”必须删除composer.lock重装；二者原因与解法截然不同，混用无效。
绕过 Composer install 的版本检测失败，关键要分清是“平台要求不满足”还是“依赖版本冲突”——前者用 --ignore-platform-req 类参数，后者必须删 composer.lock 重算，混用无效。
报错是 “platform requirements mismatch” 怎么办
这类错误明确指向 PHP 版本、扩展缺失或系统库不匹配，比如 Root composer.json requires php ^8.2 but your php version (8.1.26) does not satisfy that requirement 或 ext-gd is missing。
-
--ignore-platform-reqs能一次性跳过所有平台检查，但风险高：它不装扩展、不升 PHP，装完可能运行时报Fatal error - 更稳妥的是精准跳过：只绕过 PHP 版本用
composer install --ignore-platform-req=php；只跳 GD 扩展用composer install --ignore-platform-req=ext-gd；可叠加多个，如--ignore-platform-req=php --ignore-platform-req=ext-curl - 别写成
--ignore-platform-reqs=true或--ignore-platform-req=php=8.1—— Composer 不认，直接报错 - 永久关闭（仅限当前项目）：在
composer.json的"config"段加"platform-check": false，不影响其他项目
报错是 “Your lock file does not contain a compatible set of packages” 怎么办
这是锁文件和 composer.json 的依赖约束对不上，典型如把 "monolog/monolog": "^3.0" 写进 composer.json，但 composer.lock 里还是 2.9.0。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
--ignore-platform-reqs对这个错误完全无效——它不管依赖版本，只管 PHP 和扩展 - 唯一有效方式是删掉
composer.lock，再跑composer install，让 Composer 重新按composer.json解析整棵树 - 删 lock 文件前先确认：是否真需要升级？有没有 CI 流水线依赖旧版本？生产环境严禁直接操作
- 如果只想强制装某个包（如
foo/bar:1.2.3），先用composer prohibits foo/bar:1.2.3查谁在阻止，比硬删 lock 更安全
CI/CD 中常见误操作和替代方案
很多 CI 脚本盲目加 --ignore-platform-reqs，结果 PHP 版本低导致某些包根本下载失败，或扩展缺失让 intervention/image 安装中断——这其实是平台问题；而真正卡住的可能是 symfony/console 和 laravel/framework 的语义化版本冲突，--ignore-platform-reqs 对它毫无作用。
- 构建镜像时，优先统一 PHP 版本和扩展，而不是靠参数绕过
- 若必须用低版本 PHP 构建，可在
composer.json的config.platform里设"php": "8.1.28"（注意写完整版本号），再composer update --lock生成适配的 lock 文件 -
--no-interaction和--prefer-dist可配合使用，但它们不解决任何校验问题 - 遇到
Checksum validation failed？这不是版本检测，而是缓存或镜像同步问题，得清缓存 + 换源，不是加 ignore 参数能解决的
最易被忽略的一点：--ignore-platform-req=php 只跳过版本校验，不跳过语法兼容性。PHP 8.1 强装 Laravel 11，composer install 成功，php artisan 第一行就崩——因为 Laravel 11 用了 PHP 8.2 的新特性。绕过检测不等于能跑，得自己兜底验证运行时行为。
