必须按优先级验证环境变量>项目级repositories>全局config>默认源；执行echo $composer_repo_packagist、composer config repo.packagist、composer config -g repo.packagist，并以composer diagnose -v末尾显示https://repo.packagist.org才算成功回退。
要确认 Composer 仓库配置是否真正起作用，不能只看配置命令是否执行成功，必须验证实际请求是否命中镜像源、是否被项目级配置覆盖、是否读取到正确的 provider 元数据。
检查当前生效的 repositories 配置
运行 composer config --list | grep repositories，观察输出中是否有 repositories.packagist 或 repositories.repo-name 类似字段。若完全无输出，说明全局和项目均未显式配置仓库，Composer 将使用默认源（即 packagist.org）。
重点看带 (global) 标记的行——它表示该配置来自用户级 config.json；没标记的则可能来自项目 composer.json。注意：项目级 repositories 数组一旦存在，会【完全屏蔽】全局配置，哪怕你只加了一条私有 Git 源。
验证镜像源是否真实生效
执行 composer config -g repo.packagist，输出必须是完整 JSON 对象，例如：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
以下任一情况都代表未生效：
• 输出为空或 null
• 输出是纯字符串如 "https://mirrors.aliyun.com/composer/"
• 输出仍是 https://packagist.org
• URL 缺少末尾斜杠（如 https://mirrors.tuna.tsinghua.edu.cn/composer → 必须是 https://mirrors.tuna.tsinghua.edu.cn/composer/）
常见静默失败原因：字段名拼错成 repos.packagist（多一个 s），Composer 不报错但直接忽略；旧版 Composer 1.x 不支持 repo.packagist，需改用 composer config -g repos.packagist '{"type":"composer","url":""}'。
确认网络请求是否走镜像
第一步：清空旧缓存，避免 Composer 继续读取本地残留的官方元数据：composer clear-cache。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
第二步：用详细日志模式触发一次元数据拉取：composer install -vvv 2>&1 | grep -i "GET https.*p2/"。
第三步：检查输出中是否出现类似 GET https://mirrors.aliyun.com/composer/p2/monolog/monolog.json 的请求地址。如果看到的是 packagist.org 或根本无 p2/ 路径，说明镜像未生效或被项目 composer.json 中的 repositories 覆盖。
注意：CI 环境中若用 sudo composer config -g，配置写入了 root 用户目录，但普通 runner 用户无法读取，必须确保执行用户与配置用户一致。
排查 provider 元数据是否过期
方法一：手动检查缓存目录是否存在对应镜像的 provider 文件
Linux/macOS 下运行：ls -d ~/.composer/cache/repo/https---mirrors.aliyun.com-composer；Windows 下查 %APPDATA%\Composer\cache\repo\https---mirrors.aliyun.com-composer。若目录不存在或为空，说明 provider 数据未下载或已被清除。
方法二：强制刷新 provider 缓存（Composer ≥ 2.5）：composer update --refresh。该命令专清 provider-*.json 类文件，解决“包明明存在却提示找不到”的典型问题。
方法三：直接删除整个镜像 provider 缓存目录：rm -rf ~/.composer/cache/repo/https---mirrors.aliyun.com-composer，再执行任意依赖操作触发重拉。
