composer 提示 "The checksum verification failed" 怎么办？

首先清除 Composer 缓存并重新安装，具体操作为运行 composer clear-cache，删除 vendor 和 composer.lock 后执行 composer install；若问题依旧，可检查或切换镜像源至官方源 https://packagist.org 排查同步问题。

当你在使用 Composer 安装或更新 PHP 包时，遇到 "The checksum verification failed" 错误，说明 Composer 下载的文件与包注册中心（通常是 packagist.org）记录的校验值不一致。这可能是网络问题、缓存损坏或临时服务器异常导致的。下面是一些有效的解决方法：

清除 Composer 缓存

Composer 会缓存下载的包，如果缓存文件损坏，就可能引发校验失败。

• composer clear-cache 或 composer clearcache

清除后重新执行你的 composer install 或 composer update 命令。

删除 vendor 目录和 composer.lock

有时 composer.lock 文件中记录的版本与实际下载不符，也可能导致校验失败。

• 删除 vendor/ 目录：rm -rf vendor
• 删除 composer.lock 文件：rm composer.lock
• 重新运行：composer install

检查网络或镜像源是否可靠

如果你使用了国内镜像（如阿里云、华为云等），偶尔镜像同步延迟会导致文件不一致。

Starry.ai

AI艺术绘画生成器

35

查看详情

• composer config --global repo.packagist composer https://packagist.org

然后再尝试安装。确认无误后，可再切回镜像加速。

手动验证或跳过校验（不推荐）

仅在确认安全的前提下，可临时跳过校验用于排查问题：

• composer install --no-verify-storage

这个选项会跳过文件完整性检查，但不应在生产环境使用。

基本上就这些常见处理方式。大多数情况下，清缓存 + 重装就能解决。如果问题持续，检查网络环境或尝试更换镜像源。

以上就是composer 提示 "The checksum verification failed" 怎么办？的详细内容，更多请关注php中文网其它相关文章！