解决composer "The checksum verification failed"错误

清除缓存、切换镜像源、重建依赖可解决Composer校验失败问题，多数因网络或缓存导致而非安全威胁。

当你在使用 Composer 安装或更新 PHP 包时，遇到 "The checksum verification failed" 错误，说明 Composer 下载的文件与预期的校验值不匹配。这通常是为了防止恶意篡改而设置的安全机制。虽然看起来吓人，但大多数情况下是网络或缓存问题导致的，而非真正的安全威胁。

清除 Composer 缓存

Composer 会缓存下载的包以加快后续安装速度，但如果缓存文件损坏或不完整，就可能引发校验失败。

运行以下命令清除缓存：

或使用：

清除后重新执行你的 composer install 或 update 命令，看是否解决问题。

检查网络和镜像源

如果你在中国大陆或使用了第三方镜像源（如阿里云、华为云等），网络不稳定或镜像同步延迟可能导致下载内容不完整。

可以临时切换回官方源进行测试：

然后再运行安装命令。如果成功，说明原镜像有问题，可尝试更换其他镜像或稍后再试。

手动删除 vendor 和 lock 文件（谨慎操作）

如果问题集中在某个特定项目，可以尝试彻底重建依赖：

Kerqu.Ai

专为电商设计的一站式AI创作平台

202

查看详情

• 删除 vendor 目录
• 删除 composer.lock 文件
• 运行 composer install

这会让 Composer 重新解析并下载所有依赖，避免旧锁文件引用了异常版本。

跳过校验（仅限调试，不推荐生产环境）

作为临时排查手段，你可以让 Composer 跳过校验（不推荐长期使用）：

这个选项能绕过校验失败问题，帮助确认是否为校验机制本身导致。若跳过校验后能正常安装，基本可确定是下载过程出错，而非包本身被篡改。

检查 PHP 和 OpenSSL 配置

极少数情况下，PHP 的 hash 扩展或 OpenSSL 配置异常会影响校验计算。

确保你使用的 PHP 版本正常，且以下扩展已启用：

• hash
• openssl

可通过 php -m 查看已加载模块。

基本上就这些。多数“checksum verification failed”问题通过清缓存、换源或重装依赖就能解决。关键是不要直接忽略错误，先排查原因，确保不是潜在的安全风险。

以上就是解决composer "The checksum verification failed"错误的详细内容，更多请关注php中文网其它相关文章！