多层嵌套JSON Schema校验异常：GUI字段类型错误未被识别

问题根源 #

你的GUI Schema定义active为boolean类型，但传入字符串"true"未被识别为错误，大概率是因为校验器开启了类型强制转换，自动将合法字符串形式的布尔值转为布尔类型，绕过了严格类型校验；也可能是schema定义存在宽松设置，或者引用的schema未被正确加载。

解决方法 #

1. 关闭校验器的类型强制转换

不同校验器的配置方式不同，以常用的Ajv为例：
初始化校验器时关闭类型自动转换，确保严格匹配schema定义的类型：

const Ajv = require('ajv');
const ajv = new Ajv({ coerceTypes: false }); // 禁用类型强制转换

此时字符串"true"会被直接判定为不符合boolean类型的错误。

如果使用Zod等默认严格校验的库，无需额外配置，只要schema定义为z.boolean()，字符串形式的布尔值会直接触发校验错误。

2. 严格定义GUI Schema的类型

检查并修改gui.json中active字段的定义，确保仅允许boolean类型：

{
  "type": "object",
  "properties": {
    "active": {
      "type": "boolean",
      "description": "仅接受布尔类型的true/false，不允许字符串"
    }
  },
  "required": ["active"], // 可选，若该字段为必填
  "additionalProperties": false // 可选，防止额外未知字段干扰校验
}

如果之前的schema中存在type: ["boolean", "string"]这类宽松设置，直接删除字符串类型选项即可。

3. 兼容字符串布尔值（若业务需要）

如果必须接受字符串形式的"true"/"false"，同时过滤其他非法字符串，可以用oneOf定义多类型校验规则：

{
  "type": "object",
  "properties": {
    "active": {
      "oneOf": [
        { "type": "boolean" },
        { "type": "string", "enum": ["true", "false"] }
      ],
      "description": "允许布尔类型或合法字符串形式的布尔值"
    }
  }
}

配合校验器的类型强制转换（如Ajv的coerceTypes: true），可自动将合法字符串转为布尔值，同时拒绝"yes"这类非法值。

4. 确认schema引用有效性

检查content.json、tool.json、gui.json之间的引用路径是否正确，确保校验器正确加载了所有依赖的schema文件，避免因引用失效导致校验规则未生效。

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