Composer报“invalid”类错误根本原因是解析阶段语法或格式校验失败，JSON非法、包名违规或URL协议不被白名单允许，必须当场修正源文件或命令输入，清缓存、换镜像、重装均无效。
Composer 报 “invalid” 类错误（如 invalid package name、invalid repository URL、composer.json is not valid）根本不是网络或缓存问题，而是解析阶段直接失败——它连包都没开始下，就卡在语法、格式或协议校验上。这类错误必须当场修复源文件或命令输入，重试、换镜像、清缓存全无效。
为什么 composer.json is not valid 不能靠重装解决
这个错误发生在 Composer 读取配置文件的第一步，JSON 解析器直接抛异常，后续流程全部跳过。常见诱因不是内容逻辑错，而是肉眼难见的格式破坏：
- 末尾多了一个逗号（尤其在
require或autoload最后一项后） - 用了单引号代替双引号（JSON 标准只认双引号）
- 文件含 UTF-8 BOM 头（Windows 记事本常偷偷加）
- 复制粘贴时混入全角空格或不可见控制字符
验证方法：运行 php -r "json_decode(file_get_contents('composer.json')); echo json_last_error_msg();"，输出必须是 JSON_ERROR_NONE。救急最小结构：{"name":"vendor/name","require":{}}。
invalid package name 的命名硬规则
Composer 对包名执行严格正则校验，不满足就立刻中断，不会尝试“猜你想输什么”。有效格式只有一种：vendor/name，且：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须含且仅含一个斜杠（
/），前后都不能为空 - 所有字符只能是小写字母、数字、
-、_、. - 禁止大写字母（
Laravel/Framework❌）、空格（my package❌）、@（foo@bar/baz❌） - 命令行安装时也必须输全名，
composer require monolog/monolog✅，composer require Monolog❌
检查方式：运行 composer validate，它会明确指出哪一行、哪个字段不合法。
Invalid repository URL 是协议白名单拦截
这个错误和网络通不通无关，是 Composer 在解析 repositories 配置时，发现 URL 协议不在内置白名单里（默认只接受 https、git、http）。最典型的是把 SSH 地址写成 git@gitlab.com:user/pkg.git —— 它根本不会尝试连接，解析阶段就报错。
- SSH 必须改写为
git+ssh://git@gitlab.com:22/user/pkg.git（开头强制git+） - 内部 HTTP 服务若用自签名证书，需额外加
"options": {"http": {"ssl": {"verify_peer": false}}} - 哪怕只错一个 URL，整个
repositories数组都会被拒绝加载，其他正确项也失效 - 运行
composer config --list查看是否被全局配置覆盖，项目级repositories永远优先生效
哪些操作纯属浪费时间
面对 “invalid” 类错误，以下动作毫无意义：
-
composer clear-cache：缓存里没存 JSON 或 URL 格式，清了也不影响解析 -
rm -rf vendor && composer install：vendor 目录压根没生成，删了也没用 -
--no-plugins --no-scripts：插件和脚本执行在解析成功之后，到不了那一步 - 换镜像源：
repo.packagist配置只影响包下载，不影响本地文件校验
真正要盯住的，只有三样东西：你刚保存的 composer.json 文件、你敲进终端的那条命令、以及 composer validate 输出的第一行错误提示——其余全是干扰项。
