报Invalid configuration或JSON schema不匹配，说明composer.json字段类型或结构违法，如psr-4写成数组、scripts值为布尔、config.platform.php用数字而非字符串；应先运行composer validate定位错误行与预期类型，再检查不可见字符、BOM头或vendor/lock残留。
报 Invalid configuration 或 does not match the expected JSON schema，基本可以确定是 composer.json 里某处字段写法不合法，不是 Composer 坏了，也不是网络问题。
运行 composer validate 定位具体哪一行哪一字段
它会直接告诉你出错位置和类型预期，比如 expected object but got string。别跳过这步靠肉眼扫——中文引号、多一个逗号、psr-4 写成数组而不是对象，这些错误人眼极难发现。
- 执行
composer validate --verbose可看到更详细的 schema 违反提示 - 若输出
./composer.json is valid，但install仍失败，说明是语义错误（如路径不存在、PHP 版本不匹配），不是语法问题 - VS Code 或 PHPStorm 启用 JSON Schema 校验后，编辑时就能实时标红，比跑命令更快
检查 autoload 和 scripts 字段的值类型是否合规
这两个字段最容易踩坑：它们对值的类型有硬性要求，写错类型就直接报配置非法。
-
autoload.psr-4必须是对象，例如{"App\": "src/"}；写成数组[{"App\": "src/"}]就会失败 -
scripts的每个键值必须是字符串或对象（如"post-install-cmd": "php artisan optimize"），不能是数字、true或null -
config.platform.php的值必须是字符串（如"8.2.0"），写成8.2（数字）会被 schema 拒绝
确认没有混入不可见字符或非法符号
JSON 解析失败常因肉眼不可见的污染，composer validate 有时不报，但 php -r 会立刻暴露。
- 执行
php -r "json_decode(file_get_contents('composer.json')) || die('JSON error: '.json_last_error_msg());"，PHP 8+ 还会返回偏移量，配合编辑器「显示不可见字符」功能秒定位 - 粘贴内容到 jsonlint.com，它会高亮标出 BOM、零宽空格（U+200B）、全角冒号等
- 用
jq '.' composer.json（需先装jq）：失败时直接输出行列号，比validate更底层、更敏感
排除 composer.lock 或 vendor/ 残留导致的误判
有时候报错看着像配置问题，实际是 composer.lock 文件损坏或与 composer.json 不同步，导致 Composer 在解析依赖图时读到非法结构。
- 删掉
composer.lock和vendor/目录，再跑composer install—— 这是最干净的重置方式 - 如果项目用了 CI/CD，注意构建用户和部署用户可能不同，
vendor/权限错位也可能让 Composer 在读取 lock 文件时触发解析异常 - 某些 IDE 或编辑器保存时自动加 BOM，尤其 Windows 下用记事本改过文件，务必检查编码是否为 UTF-8 无 BOM
真正麻烦的不是语法错误，而是那些 validate 说“合法”、install 却失败的情况：比如 psr-4 映射的目录根本不存在，或者 config.platform.php 声明的版本和当前 php -v 不一致——这些得靠 composer install --dry-run 或手动验证环境才能揪出来。
