0

0

composer提示 "The checksum verification failed" 怎么解决

尼克

尼克

发布时间:2025-10-14 20:17:01

|

970人浏览过

|

来源于php中文网

原创

答案:Composer校验失败通常因缓存或网络问题导致。1. 清除缓存:运行composer clear-cache;2. 删除vendor和composer.lock后重装;3. 使用阿里云等国内镜像源;4. 临时用--no-verify-checksums跳过校验(不推荐生产环境);5. 检查系统时间是否同步。优先清理缓存并切换镜像源可解决多数情况。

composer提示 \

出现 "The checksum verification failed" 错误,说明 Composer 在下载某个包时,校验文件完整性失败。这通常是因为下载的文件与官方记录的哈希值不匹配,可能是网络问题、缓存损坏或资源临时异常导致的。

1. 清除 Composer 缓存

最常见的原因是本地缓存文件损坏。运行以下命令清除缓存:

composer clear-cache

或使用:

composer clear-config-cache

然后再尝试重新安装或更新:

composer install

2. 删除 vendor 目录和 composer.lock

如果清除缓存无效,可以尝试彻底重置依赖:

  • 删除 vendor 目录
  • 删除 composer.lock 文件(注意:这会导致依赖版本可能升级)
  • 重新运行:
composer install

3. 检查网络或镜像源

如果你在国内,建议使用国内镜像(如阿里云、中国科技大等),避免因网络不稳定导致下载出错。

设置阿里云镜像:

PpcyAI
PpcyAI

泡泡次元AI-游戏美术AI创作平台,低门槛上手,高度可控,让你的创意秒速落地

下载
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

之后再执行安装命令。

4. 临时关闭校验(不推荐长期使用)

如果只是想跳过当前错误(例如调试环境),可临时禁用校验:

composer install --no-verify-checksums

注意: 这会降低安全性,仅用于排查问题,不建议生产环境使用。

5. 检查 PHP 或系统时间是否正确

极少数情况下,系统时间不准确可能导致 HTTPS 请求验证失败,间接影响文件下载完整性。确保服务器时间同步:

date # 查看时间 timedatectl set-ntp true # Linux 系统开启自动同步

基本上就这些常见原因和解决方法。先清缓存、换镜像,多数情况都能解决。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

154

2023.12.25

http与https有哪些区别
http与https有哪些区别

http与https的区别:1、协议安全性;2、连接方式;3、证书管理;4、连接状态;5、端口号;6、资源消耗;7、兼容性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2113

2024.08.16

磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

1415

2023.06.21

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

706

2023.06.29

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

295

2023.06.30

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

782

2023.07.05

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

575

2023.07.06

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

550

2023.07.20

C++ 设计模式与软件架构
C++ 设计模式与软件架构

本专题深入讲解 C++ 中的常见设计模式与架构优化,包括单例模式、工厂模式、观察者模式、策略模式、命令模式等,结合实际案例展示如何在 C++ 项目中应用这些模式提升代码可维护性与扩展性。通过案例分析,帮助开发者掌握 如何运用设计模式构建高质量的软件架构,提升系统的灵活性与可扩展性。

8

2026.01.30

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 10.2万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.2万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号