答案：先运行composer install --dry-run定位具体缺失扩展，再用php -m | grep -i xxx验证是否启用，并确认CLI模式下php.ini路径及扩展配置正确。
composer install 报错“ext-xxx missing”怎么定位
Composer 在安装依赖时提示 ext-xxx 缺失，本质是它在读取 composer.json 中的 require 或 require-dev 项后，比对当前 PHP 环境是否启用了对应扩展。不是所有扩展名都和 php -m 输出完全一致，比如 ext-iconv 对应模块名是 iconv，但 ext-gd 就是 gd。
快速定位方法：
- 运行
composer install --dry-run，它会跳过实际安装，只做依赖检查，错误信息更干净 - 查看报错里具体的
ext-xxx，例如The requested PHP extension ext-pdo_mysql is missing→ 关注pdo_mysql - 执行
php -m | grep -i pdo_mysql（Linux/macOS）或php -m全量看（Windows），注意大小写不敏感，但模块名不含ext-前缀 - 若用 Docker，别只查宿主机的
php -m，要进容器查：docker exec -it your-php-container php -m
php.ini 里 extension=xxx.so 没生效的常见原因
即使写了 extension=gd.so，PHP 也可能没加载成功，php -m 里依然看不到。这不是 Composer 的问题，而是 PHP 自身加载失败。
排查要点：
立即学习“PHP免费学习笔记（深入）”；
- 确认
php --ini输出的配置文件路径是否是你修改的那个；多个.ini文件时，后加载的会覆盖前面的extension= -
extension=gd.so要写在php.ini主文件或被 include 的文件中，不能放在conf.d/下某个被注释掉的文件里 - Linux 上扩展文件名可能是
gd.so，macOS 是gd.so或gd.bundle，Windows 是php_gd2.dll—— 名称必须严格匹配 - 扩展依赖其他库（如
gd依赖libpng、freetype），缺少底层系统库会导致加载静默失败，此时php -m不显示，php -i | grep gd也无输出
如何让 Composer 显示更详细的扩展检查过程
默认情况下 Composer 只报错，不说明它依据哪条规则判定缺失。加 -v 参数可看到判断逻辑：
composer install -v
你会看到类似这样的输出：
Checking platform settings: OK Checking git settings: OK Checking http connectivity to packagist: OK Checking https connectivity to packagist: OK Checking github rate limit: OK Checking disk free space: OK Checking pubkeys: Tags Public Key Fingerprint: ... OK Dev Public Key Fingerprint: ... OK Checking composer version: OK Checking extension <code>mbstring</code>: OK Checking extension <code>xml</code>: OK Checking extension <code>curl</code>: OK Checking extension <code>zip</code>: FAILED
这个列表就是 Composer 实际校验的扩展项，顺序和 composer.json 中声明的 platform 或包的 require 有关。如果某扩展反复显示 FAILED 但你确定已启用，大概率是 PHP CLI 和 Web SAPI 使用了不同配置（比如 Apache 用的是 /etc/php/8.2/apache2/php.ini，而 CLI 用的是 /etc/php/8.2/cli/php.ini）。
某些扩展在 CLI 和 FPM 下行为不一致怎么办
最典型的是 pdo_mysql：Web 页面能连 MySQL，但 composer install 报错说缺 ext-pdo_mysql。这是因为 Composer 运行在 CLI 模式下，读的是 CLI 版本的 php.ini，而 Web 请求走的是 FPM 或 Apache 模块，用的是另一套配置。
验证方式：
- 分别运行
php -i | grep 'Loaded Configuration File'和php-fpm -i | grep 'Loaded Configuration File'（或phpinfo()页面）对比路径 - 确保 CLI 的
php.ini里也启用了对应扩展，比如在/etc/php/8.2/cli/php.ini中加入extension=pdo_mysql - Ubuntu/Debian 系统常用
phpenmod -s cli xxx启用扩展（-s cli指定作用域），而不是手动改 ini - 如果你用 XAMPP/MAMP，CLI 的 PHP 往往指向系统自带版本，跟面板里启动的不是同一个，这时需要把 MAMP 的 bin 目录加到
$PATH前面
扩展是否启用，最终只取决于 php -m 的输出，和你用什么 IDE、什么终端无关。最容易忽略的是：你以为改好了，其实改的是另一个 PHP 版本的配置。
