首先清除 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
检查网络或镜像源是否可靠
如果你使用了国内镜像(如阿里云、华为云等),偶尔镜像同步延迟会导致文件不一致。
可以临时切换回官方源测试:composer config --global repo.packagist composer https://packagist.org
然后再尝试安装。确认无误后,可再切回镜像加速。
手动验证或跳过校验(不推荐)
仅在确认安全的前提下,可临时跳过校验用于排查问题:
composer install --no-verify-storage
这个选项会跳过文件完整性检查,但不应在生产环境使用。
基本上就这些常见处理方式。大多数情况下,清缓存 + 重装就能解决。如果问题持续,检查网络环境或尝试更换镜像源。










