composer install 默认不检查系统架构，因为它仅依据composer.lock还原依赖，不验证php架构、版本或扩展abi兼容性；真正适配需删composer.lock后执行composer update --with-all-dependencies，使composer按当前环境重新解析并筛选适配包。
Composer install 为什么默认不检查系统架构？
因为 composer install 默认只校验 composer.lock 中记录的依赖哈希和版本，不验证扩展是否匹配当前 PHP 架构（比如 x86_64 vs aarch64）、PHP 版本、或扩展 ABI 兼容性。它假设 lock 文件是“可复现”的——但这个假设在跨平台（如 macOS 开发、Linux 生产）或跨架构（Intel → Apple Silicon）时经常失效。
如何让 Composer 拉取真正适配当前系统的依赖？
关键不是“强制拉取”，而是让 Composer 在安装时主动识别并选用适配当前环境的包变体（尤其是含二进制扩展的包，如 ext-gd、ext-redis、grpc）。需组合使用以下配置：
- 确保
composer.json中声明了目标平台：添加"platform": {"php": "8.2.12", "ext-zip": "1.22.0"}（值必须与php -v和php -m输出一致） - 运行
composer install --ignore-platform-reqs是反模式——它跳过检查，反而导致不兼容扩展被装上 - 正确做法是先清理旧 lock：
rm composer.lock，再执行composer update --with-all-dependencies，让 Composer 重新解析所有依赖并按当前php -v和php -i | grep architecture结果筛选可用版本 - 对含预编译二进制的包（如
laravel/octane、spiral/roadrunner），必须确认其composer.json中定义了platform-check或bin-compat约束，否则 Composer 无法感知架构差异
常见报错及对应修复动作
遇到类似 PHP Warning: Module 'gd' already loaded in Unknown on line 0 或 Class 'Swoole\Http\Server' not found，往往不是 Composer 问题，而是：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 本地已启用某扩展（如
extension=gd.so），但 Composer 安装的包又自带同名扩展逻辑，冲突 —— 解决：统一用系统扩展，删掉包内 bundled extension -
composer.lock里记录的是 x86_64 的grpc扩展，但在 M1 Mac 上运行 —— 解决：删 lock，设export COMPOSER_ARCH=aarch64（部分新版插件支持），再composer update - PHP CLI 和 Web Server 使用不同
php.ini，导致composer install时检测的是 CLI 环境，但运行时走的是 FPM 的扩展路径 —— 解决：始终用php -c /path/to/web/php.ini -r "print phpversion();"校验目标环境后再装
哪些依赖真正受架构影响？
绝大多数纯 PHP 包（如 symfony/console）完全不受影响；真正需要关注的只有三类：
- 带
bin/目录且含平台相关二进制的包（如pestphp/pest的bin/pest可能为 x86_64 编译） - 声明了
ext-*依赖且该扩展有 ABI 差异（如ext-sodium在 PHP 8.1+ 有 API 变更） - 使用
composer-plugin动态编译的包（如inotify、ev），它们会在post-install-cmd阶段调用phpize+make，此时才真正依赖系统架构
这些场景下，composer install 本身不“拉取架构目标”，而是靠后续钩子或运行时加载机制适配——所以别指望一条命令解决所有问题，得看具体包怎么设计它的安装流程。
