tv4是Postman中唯一可行的JSON Schema校验方案，因其轻量、兼容draft-04/draft-07且原生支持；需手动注入、严格匹配语法，仅校验结构不校验字段值内容，失败时须打印result.errors调试。
tv4 做 JSON Schema 校验，不是“加个断言就行”，而是必须手动引入库、严格匹配 schema 语法、且不能依赖 Postman 自带的 JSON 验证提示——它根本不会报 schema 错误，只会静默失败。
为什么 tv4 是唯一可行的 JSON Schema 断言方案
Postman 内置的 pm.response.json() 只能解析响应体，不提供结构校验能力；官方没集成任何 JSON Schema 验证器，tv4 是社区长期验证稳定、体积小（仅 ~3KB）、支持 draft-04/draft-07 的轻量库，被 Postman 脚本环境原生兼容。其他方案如 ajv 会因缺少 require 或 Buffer 支持直接报 ReferenceError: require is not defined。
-
tv4必须通过eval()注入全局作用域，不能用import或const tv4 = ... - 它不校验字段值内容（比如字符串是否匹配正则），只校验类型、嵌套层级、必填项、数组长度约束等结构层面规则
- schema 中若含
$id、definitions等高级字段，tv4默认不处理，需额外调用tv4.addSchema()
tv4 断言脚本必须写对这三处
以下是最简可用模板，复制进 Tests 标签页即可运行：
var schema = {
"type": "object",
"required": ["code", "message", "data"],
"properties": {
"code": {"type": "number"},
"message": {"type": "string"},
"data": {"type": ["object", "array", "null"]}
}
};
// 必须先注入 tv4（Postman 8.0+ 已内置，但旧版需手动粘贴完整源码）
// 此行不可省略，否则 tv4 is not defined
if (typeof tv4 === 'undefined') {
eval(pm.globals.get("tv4")); // 建议把 tv4 源码存为全局变量避免重复加载
}
var data = pm.response.json();
var result = tv4.validate(data, schema);
pm.test("JSON Schema validation passed", function () {
pm.expect(result.valid).to.be.true;
if (!result.valid) {
console.log("Validation errors:", result.errors);
}
});
-
schema必须是纯 JavaScript 对象字面量，不能是字符串 ——JSON.parse()后再传给tv4.validate()会丢掉注释和$id字段 -
tv4.validate()返回对象含valid（布尔）和errors（数组），不要只检查valid就完事，调试时一定要打印result.errors - 若响应中
data字段可能为null，schema 中对应字段的type必须写成数组形式：["object", "null"]，单写"object"会校验失败
常见校验失败却无提示的坑
Postman 不会主动高亮 schema 语法错误，也不会在 Test Results 里显示 tv4 的具体报错位置，失败时只显示 “Assertion failed”。
- 响应字段名拼错：比如 schema 写
"user_id"，但实际返回"userId"——tv4认为该字段缺失，报Missing required property: user_id，但你根本看不到这条日志，除非加console.log() - 数字类型误判：后端返回
"123"（字符串）但 schema 定义"type": "number"→ 校验失败；反之亦然。务必确认接口文档中字段的真实类型 - required 数组漏字段：schema 中
"required": ["a", "b"]，但响应里"a"存在而"b"为undefined或null→tv4仍判定为缺失，因为undefined和null都不满足任何type定义 - 数组 items 未定义：schema 中
"items": {"type": "string"}缺失，会导致整个数组字段校验跳过，即使内容全是数字也不会报错
动态生成 schema 的边界在哪
你可以用 pm.response.json() 提取部分字段构造 schema（比如从响应中读取 data.items[0] 推导数组元素结构），但要注意：
- 不能在 schema 里直接写
pm.response.json().data.items[0]——tv4.validate()执行时schema已被静态解析，此时pm还未初始化 - 若需基于响应动态生成 schema，必须把
schema构造逻辑写在tv4.validate()调用之前，且确保所有字段都有默认 fallback（比如data?.items?.[0] || {}） - 动态 schema 无法复用，每次请求都重新生成，不适合做回归测试基线；生产环境建议把稳定 schema 存为环境变量或全局变量
真正容易被忽略的是：schema 中的 required 列表一旦写死，就锁死了接口的向后兼容性。比如某次迭代新增了可选字段 extra_info，但旧版 schema 没包含它 —— 没问题；可一旦你把它加进 required，所有旧客户端立刻断言失败。校验结构不是越严越好，而是要和接口契约对齐。
