哈希校验失败不是文件损坏,而是 composer.lock 中硬编码的 dist.sha256 与镜像源返回的元数据不一致,常见于国内镜像同步延迟、CDN 篡改或字段缺失;需先禁用并切换回官方源,清理 vendor 和 composer.lock 后强制重装。

composer.lock哈希校验失败直接删vendor和lock文件?别急
这不是文件损坏,是 Composer 在比对 composer.lock 里硬编码的 dist.sha256(或 dist.sha1)和镜像源返回的实际包元数据不一致。国内镜像同步延迟、CDN 篡改响应、甚至删掉了 autoload 字段,都会触发这个错误。
只删 vendor/ 不行——composer.lock 还带着旧哈希,下次 install 仍会拿它去校验新包;只清缓存也不行——composer clear-cache 不动 lock 文件里的记录。
- 先禁用镜像源:运行
composer config -g --unset repos.packagist(注意是repos.packagist,带s) - 再切回官方源:运行
composer config -g repo.packagist composer https://packagist.org - 彻底清理:执行
rm -rf vendor composer.lock(Windows 用rd /s /q vendor & del composer.lock) - 强制重装:运行
composer install --no-cache --force-checksums
换过镜像后为什么还是校验失败?检查三层配置覆盖
Composer 查源顺序是:环境变量 > 当前项目 composer.json 中的 repositories > 全局配置。你全局切了阿里云,但项目里写了 "repositories": [{"type": "composer", "url": "https://packagist.org"}],那它就永远走官网。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 查项目级配置:
grep -A 5 '"repositories"' composer.json(Linux/macOS),或直接打开composer.json搜索 - 查环境变量:
env | grep COMPOSER_REPO(Linux/macOS)或echo %COMPOSER_REPO_PACKAGIST%(Windows) - 临时绕过项目配置:运行
composer config --unset repositories,或手动删掉composer.json里的repositories字段 - 验证当前生效源:
composer config repositories,输出应是你期望的顺序
切回官方源后 composer install 还卡在镜像域名?缓存没清干净
换源后不执行 composer clear-cache,Composer 会继续读取旧镜像缓存下来的 packages.json 快照,导致它以为包还在镜像里,实际请求却发向已失效的地址。
清完缓存后,用这个命令验证是否真走官方源:composer require monolog/monolog --no-install -vvv,观察终端输出中 Downloading 行的 URL —— 正确应为 https://repo.packagist.org,不是任何镜像域名。
- 如果仍见
mirrors.aliyun.com,说明某层配置残留(比如项目composer.json里还写着镜像,或环境变量未清除) - 离线环境也报错?必须加
COMPOSER_DISABLE_NETWORK=1,否则所有--no-cache都无效 - CI 流水线建议用腾讯云镜像:
https://mirrors.cloud.tencent.com/composer/,它默认开启 fallback,同步延迟时自动回源,更稳
已有 composer.lock 时硬切镜像,结果依赖解析失败?别跳过重算步骤
旧 composer.lock 固化的是包地址和哈希,但没固化源策略。你切了镜像,却直接 composer install,Composer 会按 lock 文件里记的旧哈希去新镜像找包——而新镜像可能还没同步那个 tag,或元数据格式不同,直接报 Your requirements could not be resolved。
- 正确做法是:先删掉
vendor/,保留composer.lock,然后运行composer update --lock—— 这会让新版本 Composer 用当前镜像源重算依赖树,并更新 lock 文件里的哈希和 dist URL - 如果
update --lock报错,说明镜像和 lock 冲突太深,就得走前面说的“删 lock + 强制重装”路径 - 特别注意:PHP 平台版本字段(如
"php": "8.2.10")在 lock 文件顶部,要和当前 CLI 的php -v匹配,否则update会拒绝执行

















