JSON解析失败源于本地composer.json格式错误，与镜像无关；应使用php -r、jq或jsonlint定位非法字符、BOM头等。
composer.json 解析失败不是镜像问题，而是本地文件格式错误
报 JSON decode error 时，Composer 根本还没连镜像——它卡在读取你本地的 composer.json 文件阶段。PHP 的 json_decode() 拒绝解析，错误源头永远在你机器上，和阿里云、腾讯云镜像无关。
实操建议：
- 直接运行：
php -r "json_decode(file_get_contents('composer.json')) or die('JSON error: '.json_last_error_msg());"，PHP 8.0+ 会返回带偏移量的提示（如offset 247），配合编辑器「显示不可见字符」功能，10 秒内定位问题位置 - 用
jq '.' composer.json验证：失败时输出精确行列号，比composer validate更底层、更敏感 - 粘贴内容到 jsonlint.com（关掉“允许注释”），它会高亮中文引号、全角冒号、BOM 头（
ef bb bf）、零宽空格（U+200B）等肉眼难辨的非法字符
镜像同步的 packages.json 是完整 JSON 对象，不是流式片段
国内镜像（如 https://mirrors.aliyun.com/composer/）对 packages.json 做的是全量定时同步，不是代理转发。它下载的是 packagist.org 原始的完整 JSON 文件，结构为顶层 {"packages":{...},"notify-batch":"..."}，不是分块或流式拼接的。
这意味着：
- 你看到的
Parse error on line 12 at column 5是 Composer 在解析这个远程 JSON 时出的错，但该文件由镜像方生成并托管，你无法直接修改；真正要查的是你本地composer.json或项目级repositories配置里是否写了非法 URL 模板 - 如果镜像源本身返回了损坏的
packages.json（极罕见），可访问https://mirrors.aliyun.com/composer/packages.json手动 curl 下来，用jq '.'验证是否合法 - 镜像不参与任何 JSON 解析逻辑，只提供静态文件；所有
json_decode()行为都发生在你本地 PHP 进程中
config -g repo.packagist 写错一个字符就静默失效
composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 这条命令看似简单，但必须同时满足三个硬性条件，缺一即回退官方源，且不报错、不提示。
关键检查点：
- 键名必须是
repo.packagist（单数，不能是repos或repository） - type 值必须显式存在：全局配置本质是写入一个 JSON 对象，形如
{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；漏掉"type": "composer"就会 fallback - URL 必须以
/结尾：少斜杠会导致请求拼成/composerpackages.json，返回 404 且无明确提示 - 验证是否生效：运行
composer config -g repo.packagist，输出必须是完整 JSON 对象；若为空、null或报Key does not exist，说明根本没写进去
项目级 repositories 字段会完全屏蔽全局镜像
只要项目根目录的 composer.json 里有 repositories 字段，无论内容是否为空，全局镜像都会被跳过。这是 Composer 的硬编码优先级规则：项目级 > 全局 > 默认源。
常见陷阱与修复方式：
-
"repositories": {}这种空对象也会触发禁用默认源，导致全局镜像彻底不走 - 安全写法是手动编辑
composer.json，确保repositories是数组，并按顺序声明：{"packagist.org": false}（禁用默认）、{"packagist": {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}}（启用镜像）、再追加私有源 - 千万别用
composer config repo.packagist ...（不加-g）去覆盖整个字段——它会清空你已有的 Git 私有源配置
最易被忽略的一点：镜像只加速网络 IO（拉取 packages.json、下载 zip），不改变任何 JSON 解析行为。所有解析错误、格式校验、依赖求解，全在本地发生，和镜像服务器无关。排查时先砍掉「网络慢」「镜像挂了」这类直觉判断，回到 composer.json 和配置层级逐层验证。
