如何修复Composer因zlib_decode()错误导致的解压失败？

Composer zlib_decode()错误源于PHP zlib扩展异常、ZIP损坏、网络中断或zlib库版本不兼容；需检查zlib启用状态、清缓存、禁用ZIP校验或改用Git源码安装。

这个问题通常出现在 Composer 下载或解压 ZIP 包时，zlib 扩展无法正确解码压缩流，导致 zlib_decode(): data error 或类似错误。根本原因多为 PHP zlib 扩展异常、ZIP 文件损坏、网络中断导致包不完整，或系统级 zlib 库版本不兼容。

检查并修复 PHP zlib 扩展状态

Composer 依赖 PHP 的 zlib 扩展处理 ZIP 解压。先确认扩展已启用且工作正常：

• 运行 php -m | grep zlib，确保输出包含 zlib
• 执行 php -r "echo function_exists('zlib_decode') ? 'OK' : 'Missing';"，应返回 OK
• 若缺失，Linux 用户可安装（如 Ubuntu）：sudo apt install php-zip php-zlib；macOS 使用 Homebrew 安装对应 PHP 版本的 zlib 模块
• 重启 Web 服务或 CLI PHP 环境后重试

清除 Composer 缓存并跳过本地解压验证

损坏的缓存 ZIP 文件会反复触发 zlib 错误。强制清理并临时绕过校验可快速验证是否为缓存问题：

标签： php linux js git json composer npm ubuntu mac macos 环境变量 解压