composer validate 默认不校验私有字段，因其仅依据官方 json schema 进行宽松校验，将未声明字段视为“额外属性”忽略；加 --strict 会拒绝所有未定义字段，故需用 --schema 指向自定义 schema 才能校验企业私有字段。
为什么 composer validate 默认不校验私有字段？
因为 Composer 官方 JSON Schema（如 https://schema.org/composer）只定义了公开规范字段，像 private、internal-note、team 这类企业自定义字段会被当成“额外属性”忽略——除非你显式启用 --strict 或挂载自定义 Schema。
常见现象：改了 composer.json 里自定义的 vendor-policy 字段，composer validate 依然返回 OK，误以为合规，结果 CI 构建时被后端校验拦截。
-
composer validate默认行为是宽松校验，仅检查语法 + 必填字段（如name、type） - 加
--strict会拒绝所有未在 Schema 中声明的字段，但官方 Schema 不含你的私有字段 → 直接报错 - 真正可行路径：用
--schema指向你自己的 JSON Schema 文件，覆盖默认规则
如何让 composer validate 加载自定义 JSON Schema？
关键不是改 Composer 源码，而是通过命令行参数注入 Schema 路径。前提是你的 Schema 必须兼容 Composer 原有结构，并用 $ref 复用官方定义，避免重复维护。
示例：假设你把 Schema 存在项目根目录 res/composer-schema.json，其中扩展了 extra 对象，允许 extra.team 和 extra.audit-required：
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$ref": "https://raw.githubusercontent.com/composer/composer/main/res/composer-schema.json",
"properties": {
"extra": {
"properties": {
"team": { "type": "string", "minLength": 2 },
"audit-required": { "type": "boolean" }
},
"additionalProperties": false
}
}
}
执行校验时指定它：
composer validate --schema=res/composer-schema.json
- 必须用
--schema，不能靠环境变量或配置文件自动加载 - Schema 中的
$ref要指向可公开访问的原始地址（如 GitHub raw 链接），否则本地解析失败 - 若企业内网无法访问外网，需把官方 Schema 下载到本地并调整
$ref路径，例如"$ref": "./vendor/composer-schema.json"
composer validate 在 CI 中怎么避免漏掉 Schema 校验？
很多团队只在本地跑 composer validate，CI 脚本却没带 --schema 参数，导致私有规范形同虚设。
正确做法是在 composer.json 的 scripts 里固化命令：
"scripts": {
"validate:strict": "composer validate --schema=res/composer-schema.json"
}
然后 CI 步骤统一调用：
composer run validate:strict
- 不要在 CI YAML 里硬编码
--schema=...，不同仓库 Schema 路径可能不同 - 确保
res/composer-schema.json被 git 提交且路径稳定；若用 symlink，某些 CI 环境（如 GitLab Runner with Docker）可能读不到 - 如果项目依赖多个私有包，每个包应自带自己的 Schema 文件，而非共用一个中央 Schema —— 否则字段冲突或版本漂移会引发误报
自定义字段校验失败时，错误信息为什么难定位？
Composer 内部用 justinrainbow/json-schema 库做验证，报错格式极简，例如：
[ERROR] Additional properties not allowed (team)
它不会告诉你哪一行、哪个文件、是否因 additionalProperties: false 导致 —— 尤其当 Schema 里嵌套多层 $ref 时，调试成本陡增。
- 先确认报错字段是否真在你 Schema 的
properties中声明，注意拼写和嵌套层级（比如extra.team要写在extra的properties下，不是顶层） - 临时把 Schema 中对应对象的
"additionalProperties": false改成true，看是否还有其他字段被拒，排除干扰项 - 用在线工具如 JSON Schema Linter 单独验证 Schema 文件语法，
$ref循环引用或路径错误常被 Composer 静默吞掉
Schema 不是写一次就完事的，每次新增私有字段，都要同步更新 Schema 和文档，否则开发人员只会删掉字段绕过校验。
