如何在Zod Schema中实现日期字段的‘全设或全不设’验证？

要实现「两个日期字段要么都未设置（均为null），要么都已设置（均为有效日期）」的校验逻辑，可以通过Zod的refine方法为整个对象添加跨字段校验规则，具体实现如下：

修改后的完整Schema代码 #

import { z } from "zod";

export const MediumSchema = z.object({
    ImageSetID: z.number().int().positive(),
    // 保留原有其他字段
    CampaignStartDate: z.date().nullable(),
    CampaignEndDate: z.date().nullable(),
    Url: z.string().url().transform((url) => new URL(url)),
    CDNUrl: z.string().url().transform((url) => new URL(url))
}).refine(
    (data) => {
        // 校验逻辑：两个日期要么都为null，要么都不为null
        const hasStartDate = data.CampaignStartDate !== null;
        const hasEndDate = data.CampaignEndDate !== null;
        return hasStartDate === hasEndDate;
    },
    {
        message: "CampaignStartDate和CampaignEndDate必须同时设置或同时不设置",
        // 指定错误关联到两个字段（可选，方便前端定位错误）
        path: ["CampaignStartDate", "CampaignEndDate"]
    }
);

关键逻辑说明 #

• refine方法用于添加自定义校验规则，第一个参数是校验函数：
  • 先判断两个日期字段是否分别存在值（不为null）
  • 只有当两个字段的「存在状态」完全一致时，校验才通过
• 第二个参数可以自定义错误提示信息，还能通过path指定错误关联的字段，让校验失败时的错误信息更精准

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