JSON Schema中基于status.code的data属性校验异常排查

咱们先把你的需求再明确一遍：接口返回必须包含data和status两个属性，当status.code为0时data要严格符合指定业务Schema，当status.code为-1时则不对data做结构限制。现在遇到的问题是status.code=0但data是空对象时，居然能通过校验，我来帮你拆解原因并给出修复方案。

最可能的几个原因 #

你的Schema大概率在以下某一个环节出了问题：

• 条件约束逻辑没绑定到位：没有把status.code=0的判断和data的校验规则强关联，导致data的约束根本没生效
• data的Schema太宽松：比如你定义的data Schema没有设置必填属性，也没加"additionalProperties": false，空对象自然能通过
• 没限制status.code的可选值：如果允许status.code出现0和-1之外的数值，可能会干扰条件分支的判断逻辑

符合需求的完整Schema实现 #

下面是能精准满足你需求的JSON Schema，我会逐段解释关键细节：

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["data", "status"], // 确保两个属性必存在
  "properties": {
    "status": {
      "type": "object",
      "required": ["code"],
      "properties": {
        "code": {
          "type": "integer",
          "enum": [0, -1] // 锁死status.code只能是0或-1，避免其他值干扰逻辑
        }
      }
    },
    "data": { "type": "object" } // 先定义data的基础类型，后续通过条件分支细化
  },
  "oneOf": [
    {
      // 分支1：status.code=0时，data必须严格匹配业务Schema
      "properties": {
        "status": {
          "properties": {
            "code": { "const": 0 } // 精准匹配code=0的情况
          }
        },
        "data": {
          // 这里替换成你的业务Schema示例，比如要求必须有id和name
          "type": "object",
          "required": ["id", "name"], // 强制必填属性，空对象会直接被拦截
          "properties": {
            "id": { "type": "integer" },
            "name": { "type": "string" }
          },
          "additionalProperties": false // 禁止未定义的额外属性，确保严格符合结构
        }
      },
      "required": ["status", "data"]
    },
    {
      // 分支2：status.code=-1时，data可以是任意结构（true表示完全放行）
      "properties": {
        "status": {
          "properties": {
            "code": { "const": -1 }
          }
        },
        "data": true
      },
      "required": ["status", "data"]
    }
  ]
}

关键细节解释 #

• 用oneOf实现互斥分支：确保返回结果只能匹配其中一个分支，不会出现模糊匹配的情况
• const精准匹配状态码：比起范围判断，用const能明确锁定code的值，避免逻辑歧义
• additionalProperties: false：这是很多人忽略的点，加上它能禁止data出现Schema未定义的属性，配合必填属性就能彻底拦截空对象
• 枚举限制status.code：通过enum确保只有合法的状态码，避免其他值导致校验逻辑混乱

为什么你的原Schema允许空对象？ #

举个典型的错误示例，你可能只是单独定义了data的Schema，但没和status.code=0做绑定：

// 错误示例：条件逻辑未绑定
{
  "type": "object",
  "required": ["data", "status"],
  "properties": {
    "status": { /* ... */ },
    "data": {
      "type": "object",
      "properties": { "id": { "type": "integer" } } // 没有必填属性，也没限制额外属性
    }
  }
}

在这个例子里，data是空对象时，因为没有必填属性要求，且默认允许额外属性（additionalProperties默认值为true），所以自然会通过校验。

测试用例验证 #

• ✅ 合法用例（status.code=0，data符合Schema）：

  { "status": { "code": 0 }, "data": { "id": 1, "name": "test" } }
  

• ❌ 非法用例（status.code=0，data是空对象）：

  { "status": { "code": 0 }, "data": {} }
  

  会因为缺少必填的id和name属性被拦截
• ✅ 合法用例（status.code=-1，data是空对象）：

  { "status": { "code": -1 }, "data": {} }
  

内容的提问来源于stack exchange，提问作者Skefrep