composer 2.5+ 彻底移除 minimum-stability、prefer-stable、archive-format、archive-dir 等字段，出现在根级或 config 下即触发 json 解析失败；vendor-dir 和 bin-dir 不支持变量路径；需用 composer validate --no-check-all 检测并手动删除，不可用命令行参数绕过。
Composer 2.5+ 已彻底移除对 minimum-stability、prefer-stable 等旧配置项的运行时兼容支持，不是“警告”，是直接解析失败——升级后首次 composer install 就会报错，必须改配置，不能靠加参数绕过。
哪些配置项在 Composer 2.5+ 被彻底移除
不是弃用（deprecated），是删除。以下字段一旦出现在 composer.json 的根级或 config 下，就会触发 Invalid composer.json 错误：
-
minimum-stability：已被require中显式版本约束 +allow-plugins行为替代 -
prefer-stable：不再影响依赖解析逻辑，仅剩的语义由require写法隐式控制（如用"^2.0"而非"dev-main"） -
archive-format和archive-dir：自 v2.2 起废弃，v2.5+ 完全移除，composer archive命令也已删除 -
vendor-dir和bin-dir若含变量（如${HOME}/vendor）将被拒绝，只允许绝对路径或./vendor这类相对路径
升级前如何批量检测并清理过时配置
别等 composer install 报错才动手。先跑这个命令：
composer validate --no-check-all
它会跳过包元数据校验，只检查 composer.json 结构合法性，并明确标出被移除字段的位置。输出类似：
./composer.json: The property minimum-stability is not defined and the definition does not allow additional properties.
然后手动删掉对应字段即可。注意：config.platform、require-dev、autoload 等仍完全可用，不用动。
如果项目用了大量旧模板（比如某些 Laravel 8 之前的脚手架），建议用 grep -n 扫一遍：
grep -n "minimum-stability|prefer-stable|archive-" composer.json
为什么不能用 --ignore-platform-reqs 或 --no-plugins 绕过
这些参数只影响依赖安装阶段的行为，不参与 composer.json 解析。配置项移除是 JSON Schema 层面的硬性校验，发生在命令入口处，参数根本没机会生效。
常见错误操作：
- 执行
composer install --ignore-platform-reqs→ 依然报错，因为解析失败发生在参数读取之前 - 把
minimum-stability挪到config里试图“藏起来” → Schema 不认，照样拒绝 - 加
//注释掉该行 → JSON 不支持注释，直接解析失败
升级后发现 autoload 失效或 classmap 错乱
这不是配置项问题，而是 Composer 2.5+ 对 autoload 规则做了更严格的路径归一化处理。尤其注意：
-
psr-4映射中末尾斜杠"App\"必须带双反斜杠，写成"App"或"App/"会被忽略（Windows 下尤其容易错） -
classmap列表里的相对路径，现在必须相对于composer.json所在目录，不能是../src这种跨级写法 - 执行
composer dump-autoload -o后，检查vendor/composer/autoload_classmap.php是否包含你预期的类 —— 如果没有，说明路径没被识别，不是缓存问题
最稳妥的验证方式：删掉 vendor/autoload.php 和 vendor/composer/ 全目录，再跑 composer install，让 autoload 从头生成。
