如何修复Composer因zlib_decode()错误导致的解压失败？-composer-PHP中文网

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

尼克

发布： 2025-12-19 12:46:33

原创

120人浏览过

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

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

这个问题通常出现在 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 错误。强制清理并临时绕过校验可快速验证是否为缓存问题：

Uni-CourseHelper

私人AI助教，高效学习工具

查看详情

运行 composer clear-cache 彻底删除 ~/.composer/cache/ 下所有内容
添加环境变量跳过 ZIP 校验（仅调试用）：COMPOSER_DISABLE_ZIP_CHECK=1 composer install
若此时成功，说明原 ZIP 包在缓存中已损坏，后续应保持网络稳定并避免中断下载

更换下载方式：禁用 ZIP 并改用源码克隆

Composer 默认优先使用 ZIP 包（快但依赖 zlib）。若 zlib 不可靠，可强制回退到 Git 克隆源码（不经过 zlib 解压）：

在项目根目录创建或编辑 composer.json，加入配置：

"config": {
    "preferred-install": "source",
    "fxp-asset": {
        "installer-paths": {
            "npm-asset-library": "vendor/npm-asset"
        }
    }
}

登录后复制