基于AJV的JSON Schema独立模块跨字段日期比较验证方案咨询

这确实是问卷类应用中用AJV+JSON Schema时常见的痛点——独立section校验带来的上下文隔离问题。你现在用AJV后加自定义JS的方式是可行的，但确实有更优雅的方案，下面分享几个我在项目中实践过的思路：

方案一：扩展AJV自定义关键字，传递全局上下文 #

AJV允许自定义关键字，我们可以利用这个特性，在校验时把整个问卷的全局数据作为上下文传入，让跨section的字段能互相访问。这种方案最贴合JSON Schema的声明式风格，规则直接写在Schema里，维护起来更直观。

实现步骤： #

1. 定义自定义关键字（比如dateAfter）

const ajv = new Ajv({ 
  allErrors: true,
  passContext: true // 开启上下文传递
});

// 自定义"dateAfter"关键字，校验当前日期必须晚于指定路径的日期
ajv.addKeyword({
  keyword: "dateAfter",
  type: "string",
  schemaType: "string", // 接收目标字段的JSON Pointer路径，比如"/sections/0/answers/orderDate"
  validate: function(targetFieldPath, currentDate, _, context) {
    // 从全局问卷数据中获取目标字段的值
    const targetDate = ajv.getSchema().get(context.rootData, targetFieldPath);
    if (!targetDate || !currentDate) return true; // 空值跳过校验，可根据业务调整
    
    return new Date(currentDate) > new Date(targetDate);
  },
  // 自定义错误信息
  error: {
    message: "必须晚于{{schema}}对应的日期"
  },
  metaSchema: { type: "string" }
});

2. 在JSON Schema中使用关键字

{
  "type": "object",
  "properties": {
    "sections": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": { "type": "string" },
          "answers": { "type": "object" }
        }
      }
    }
  },
  "sections": [
    {
      "id": "order_info",
      "answers": {
        "order_date": {
          "type": "string",
          "format": "date"
        }
      }
    },
    {
      "id": "delivery_info",
      "answers": {
        "delivery_date": {
          "type": "string",
          "format": "date",
          "dateAfter": "/sections/0/answers/order_date" // 指定要比较的字段路径
        }
      }
    }
  ]
}

3. 执行校验时传入全局数据

const validate = ajv.compile(questionnaireSchema);
const isValid = validate(questionnaireData);

if (!isValid) {
  console.log(validate.errors); // 错误信息会包含自定义的dateAfter错误
}

优缺点： #

• ✅ 规则声明在Schema中，符合JSON Schema的设计理念
• ✅ 错误信息和AJV原生错误格式统一，前端渲染更方便
• ❌ 需要理解AJV的上下文传递机制，有一定学习成本

方案二：拆分校验阶段——先section独立校验，再全局跨字段校验 #

如果你的跨section规则非常复杂（比如涉及多个字段的组合判断），可以把校验拆成两个阶段：

1. 用AJV完成每个section的独立字段校验（格式、必填等）
2. 单独编写全局校验逻辑，处理跨section的规则

实现示例： #

// 第一步：AJV独立校验每个section
const ajvValidate = ajv.compile(questionnaireSchema);
const ajvErrors = ajvValidate(questionnaireData) ? [] : ajvValidate.errors;

// 第二步：自定义全局跨字段校验
function validateCrossSectionRules(data) {
  const errors = [];
  const orderDate = data.sections[0]?.answers?.order_date;
  const deliveryDate = data.sections[1]?.answers?.delivery_date;

  if (orderDate && deliveryDate) {
    if (new Date(deliveryDate) <= new Date(orderDate)) {
      errors.push({
        instancePath: "/sections/1/answers/delivery_date",
        keyword: "dateAfter",
        message: "到货日期必须晚于下单日期",
        schema: "/sections/0/answers/order_date"
      });
    }
  }

  // 其他跨section规则...
  return errors;
}

const crossErrors = validateCrossSectionRules(questionnaireData);

// 合并所有错误
const allErrors = [...ajvErrors, ...crossErrors];

优缺点： #

• ✅ 逻辑拆分清晰，复杂规则更容易调试和维护
• ✅ 不需要修改AJV的默认行为，学习成本低
• ❌ 规则分散在Schema和JS代码中，需要两处维护

方案三：重构Schema结构，将关联字段归为逻辑section #

如果业务场景允许，可以把有依赖关系的字段（比如下单日期和到货日期）放到同一个逻辑section中，这样AJV就能直接在section内部完成跨字段校验，不需要额外处理上下文。

示例Schema： #

{
  "sections": [
    {
      "id": "order_delivery_info",
      "answers": {
        "order_date": { "type": "string", "format": "date" },
        "delivery_date": {
          "type": "string",
          "format": "date",
          "if": {
            "properties": { "order_date": { "type": "string" } }
          },
          "then": {
            "format": "date",
            "custom": {
              "message": "到货日期必须晚于下单日期",
              "validate": (value, data) => new Date(value) > new Date(data.order_date)
            }
          }
        }
      }
    }
  ]
}

优缺点： #

• ✅ 完全利用AJV原生能力，不需要额外代码
• ✅ 规则集中在Schema中，维护简单
• ❌ 依赖业务结构调整，如果问卷的section划分是固定的（比如产品需求强制分开），这个方案不适用

方案对比与选择建议 #

• 如果希望规则完全声明式、和Schema绑定，优先选方案一
• 如果跨字段规则复杂多变，优先选方案二，逻辑更灵活
• 如果业务允许调整section结构，优先选方案三，实现成本最低

你当前用的AJV后加自定义JS的方式其实是方案二的简化版，优化的话可以把全局校验逻辑封装成可复用的函数，或者结合AJV的addFormat/addKeyword来统一错误格式，让前后端的错误处理更一致。

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