答案：hash verification failed 根因是本地 composer.lock 中硬编码的哈希值与镜像源实际提供的 dist 包元数据（如 dist.sha256、autoload 字段）不一致；需同步删除 vendor 和 composer.lock，禁用镜像后用 --no-cache --force-checksums 强制重装，再择机切回稳定镜像源。
hash verification failed 这类错误不是数据“脏”了，而是 Composer 在比对时发现本地缓存、镜像源、lock 文件三者之间哈希值对不上——它很较真，但错不在你代码里。
为什么校验失败后切回官方源就正常？
因为国内镜像（如阿里云、腾讯云）同步存在延迟或元数据精简行为：packages.json 被删掉 autoload 字段、dist.sha256 没随新 tag 更新、CDN 中间层篡改响应体，都会让 Composer 下载的包和 composer.lock 里记的哈希不匹配。这不是网络问题，是镜像“没同步全”。
- 别只清缓存——
composer clear-cache只清下载包，不碰composer.lock里硬编码的旧哈希 - 别只删
vendor/——没重生成lock，下次 install 还拿旧哈希去比新包 - 先禁用镜像：运行
composer config -g --unset repos.packagist，再设回官方源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 install 时，即使 vendor/ 和 composer.lock 都完整，也会卡在远程元数据校验上——Composer 默认要确认包是否存在、URL 是否可访问。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须设环境变量：
COMPOSER_DISABLE_NETWORK=1，否则所有--no-xxx参数都无效 - 同时加参数：
--no-plugins --no-scripts --no-autoloader，防止插件或脚本隐式联网 - 全局配置残留会 fallback 校验：运行
composer config --global repo.packagist false彻底禁用 - 装完立刻补一记：
composer dump-autoload -o，否则运行时报Class not found
PHP 版本不一致导致的“校验失败”其实是假象
你看到 This package requires php ^8.3 but your PHP version (8.1.25) does not satisfy that requirement，并不是 hash 真错了，而是 Composer 用 CLI 的 PHP 版本（php -v）去解析依赖，而 Web 环境跑的是 PHP-FPM 8.3。两者版本不统一，autoload 文件生成逻辑不同，后续运行必崩。
- 临时方案：用完整路径调用目标版本，例如
/usr/bin/php8.3 composer install - 伪装方案：在
composer.json加"platform": {"php": "8.3.0"}，仅影响安装期，运行时仍需真实匹配 - 关键动作：切换 PHP 版本后，必须删
vendor和composer.lock重装——生成的autoload_static.php会因反射行为差异而失效
hash verification failed 报错出现在 CI 日志里，但本地完全复现不了的情况——大概率是 CI 环境用了缓存镜像层，或者构建机预装的 Composer 版本与项目要求不兼容，得盯住 composer --version 和 php -v 输出是否一致。 
