更换国内镜像源、清除缓存、查看详细日志、检查PHP环境与扩展、处理依赖冲突可解决composer install失败或卡住问题。

遇到 composer install 失败或卡住的情况，通常和网络、配置、依赖冲突或环境问题有关。下面是一些常见原因及对应的解决方法，帮助你快速排查和恢复安装。

1. 检查网络连接与镜像源

Composer 默认从国外服务器下载包，国内访问容易超时或卡住。

建议操作：

• 更换为国内镜像源，例如阿里云或 Laravel China 镜像：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

• 确认服务器能正常访问外网，防火墙或代理未拦截请求。
• 如果使用代理，设置 Composer 的 HTTP 代理：

  composer config -g http-proxy http://proxy.example.com:port

2. 清除缓存并重新尝试

Composer 缓存损坏可能导致安装中断或异常。

建议操作：

• 清除 Composer 全局缓存：

composer clear-cache

• 删除项目中的 vendor 目录和 composer.lock 文件（谨慎操作）：

  rm -rf vendor/ composer.lock

• 再运行 composer install

3. 查看详细错误信息

使用更详细的输出模式定位问题。

Expanso json-flatten

通过 CLI 或 MCP 服务器，使用 Expanso Edge 管道扁平化嵌套 JSON 对象。

下载

建议操作：

• 加上 -vvv 参数查看调试日志：

composer install -vvv

• 观察卡在哪个包或步骤，判断是特定依赖问题还是整体网络问题。

4. 检查 PHP 环境与扩展

Composer 依赖的某些扩展缺失会导致安装失败。

建议操作：

• 确保 PHP 版本符合 composer.json 要求。
• 检查必要扩展是否启用，如：openssl、zip、mbstring、curl
• 通过命令查看：

  php -m | grep -E "(openssl|zip|mbstring|curl)"

5. 处理依赖冲突

当多个包版本不兼容时，Composer 会报错无法解析依赖。

建议操作：

• 尝试更新部分依赖而非全量安装：

composer update

• 或者指定具体包来调试：

  composer require vendor/package:version

• 检查 composer.json 中是否有冲突的版本约束。

基本上就这些。换源、清缓存、看日志、查环境，多数问题都能解决。