Composer对JSON格式极其严格，末尾多逗号等语法错误会导致JSON decode error；需用php -r "json_decode(file_get_contents('composer.json'));"或jsonlint.com验证，validate命令不检查依赖真实性、路径存在性及PHP版本兼容性，修复后应清缓存并重装。
composer.json 里多了一个逗号就报错
Composer 对 JSON 格式极其严格，composer.json 中任何语法错误（比如末尾多逗号、单引号、注释、未闭合的引号或括号）都会导致命令直接失败，常见报错是：JSON decode error: Syntax error 或 file could not be loaded。
别急着改 vendor 或重装 Composer —— 问题一定在你自己写的 composer.json 里。用标准 JSON 工具验证最可靠：
- 终端执行
php -l composer.json：只能检查 PHP 语法，对 JSON 无效，别用 - 正确做法是
php -r "json_decode(file_get_contents('composer.json'));" && echo 'OK' || echo 'Invalid JSON' - 更直观：用 VS Code 打开
composer.json，右下角看语言模式是不是JSON（不是JSON with Comments），且无红色波浪线 - 粘贴到 jsonlint.com 也能快速定位哪一行出错
validate 命令不报错，但 install 还是失败
composer validate 只校验 JSON 结构 + 基本 schema（比如 name 格式、必需字段），**不校验依赖是否真实存在、版本是否合法、autoload 路径是否存在**。所以它通过 ≠ 能正常 install。
典型漏检场景：
-
"require": { "monolog/monolog": "dev-main" }——dev-main在 Packagist 上不可见，validate不管，install直接报Could not find package -
"autoload": { "psr-4": { "App\": "src/" } }，但项目里根本没有src/目录 ——validate通过，dump-autoload却会警告路径不存在 - 用了
"config": { "platform": { "php": "8.3" } }，但本地 PHP 是 8.1 ——validate不检查运行时兼容性
修复后 composer install 还卡在 autoload
JSON 修复了，composer install 却卡住或报 autoload 错误，大概率是旧缓存或生成文件没清理干净。Composer 不会自动感知 composer.json 的结构变更，尤其涉及 autoload 或 repositories。
安全清理步骤：
- 删掉
vendor/目录和composer.lock（除非你明确要保留 lock 文件） - 运行
composer clear-cache，避免本地 repo 缓存干扰 - 再执行
composer install --no-cache，跳过可能损坏的缓存层 - 如果仍报
Class XXX not found，检查composer dump-autoload -o输出，确认它是否真读到了你改过的autoload配置
CI/CD 里怎么自动化防 JSON 错误
靠人肉检查 composer.json 在协作中不可靠。CI 流程里加一道轻量级校验，比等 build 失败再回滚快得多。
推荐在 GitHub Actions / GitLab CI 的 job 开头加：
php -r "json_decode(file_get_contents('composer.json')) or die('Invalid composer.json');"
或者更完整一点：
composer validate --strict --no-check-publish && php -r "json_decode(file_get_contents('composer.json')) or die('JSON parse failed');"
注意：--strict 会检查字段命名规范（如禁止 require-dev 写成 require_dev），但不会查语义错误；真正兜底的还是那行 php -r。
别指望一次配置永久有效 —— 每次改 composer.json 都得重新过这关，尤其是合并 PR 前。
