答案：composer报“无法获取包的哈希值”是因本地元数据缓存中packages.json缺失或异常dist.shasum字段，属解析阶段错误，尚未发起下载；执行composer clear-cache可强制重拉完整元数据修复，若仍失败则需检查镜像源返回的json是否规范。
这不是网络问题，是本地元数据缓存损坏或源不一致导致的校验拦截。 Composer 报“无法获取包的哈希值”，根本不是连不上服务器，而是它在读取本地缓存的 packages.json 时，发现里面缺 dist.shasum 字段，或字段为空/格式异常——这一步发生在解析阶段，压根还没开始下载。
为什么composer install会卡在“无法获取包的哈希值”
这个提示通常出现在执行 composer install 或 composer update 时，Composer 尝试从 cache/repo/ 下读取包元数据（比如 packages.json），但该文件里对应包的 dist 块缺失 shasum，或值为 null、空字符串、非十六进制字符串。
- 常见诱因是手动删过
~/.composer/cache/repo/里的部分文件，或磁盘满导致写入截断 - 某些老旧镜像源返回的
packages.json不规范（尤其私有 Satis 或自建 Toran 镜像） - PHP 的
json_decode()因内存不足或扩展限制，静默丢弃了shasum字段 - Windows 上用非 UTF-8 编码保存过
composer.json，间接污染元数据解析流程
composer clear-cache 为什么能解决这个问题
composer clear-cache 会清掉整个 ~/.composer/cache/ 目录，包括 repo/（元数据）、files/（zip 包）、http/（HTTP 响应缓存）。关键在于：它强制 Composer 下次请求时，必须重新从远程源拉取完整、新鲜的 packages.json，而新拉下来的文件大概率带全字段，dist.shasum 就回来了。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 注意：
composer cache-clear是旧别名，部分 Composer 2.2+ 版本已弃用，优先用clear-cache - 它不碰
vendor/和composer.lock，所以不会破坏当前依赖锁定 - 如果清完缓存仍报同样错，说明问题不在本地缓存，而是你正在用的源本身返回了残缺元数据
怎么确认是不是镜像源返回了坏的 packages.json
别猜，直接看原始响应体。运行下面命令，把输出里任意一个包的 dist 块贴出来检查：
curl -s https://packagist.org/packages.json | jq '.packages[] | select(.name == "monolog/monolog")'
如果你用的是阿里云镜像，把 URL 换成 https://mirrors.aliyun.com/composer/packages.json。重点看是否有类似这样的结构：
"dist": {
"type": "zip",
"url": "https://api.github.com/...",
"reference": "abc123",
"shasum": "a1b2c3d4..."
}
- 若
shasum字段缺失、为null或长度不对（SHA-256 应为 64 字符小写十六进制），就是镜像源的问题 - 国内镜像同步延迟常表现为新包有
shasum，但老包的字段被意外清空；此时切回官方源composer config -g repo.packagist composer https://packagist.org能立刻验证 - 企业内网自建源若用 Nginx 反向代理，要检查是否配置了
proxy_buffering off，否则大 JSON 响应可能被截断
真正难排查的点在于：这个错误不报具体包名，也不打堆栈，只笼统说“无法获取”，容易让人误以为是网络超时。实际只要 curl -I 能拿到 200，就几乎可以排除网络层问题——焦点必须落在元数据完整性上。
