TypeScript中Zod替代Joi.ref()实现对象字面量验证的方案

Zod没有提供和Joi的joi.ref()完全对应的直接API，但可以通过带函数的默认值实现相同的动态引用兄弟字段的效果，同时解决你遇到的TypeScript类型报错问题。

完整实现代码 #

const zodParentObject = z.object({
  someKey: z.string()
})

// 用extend替代merge，更贴合Joi keys()的语义
const zodChildObject = zodParentObject.extend({
  // 通过default的函数参数获取父对象上下文
  someChildKey: z.string().default((ctx) => ctx.parent.someKey)
})

解决"object is possibly undefined"错误 #

你遇到的类型报错是因为TypeScript无法确定ctx.parent一定存在。有两种简单的解决方式：

• 非空断言：如果能确定父对象必然存在（比如当前schema的字段都是必填），可以用!断言：

  someChildKey: z.string().default((ctx) => ctx.parent!.someKey)
  

• 兜底处理：如果父字段是可选的，添加 fallback 值避免报错：

  const zodParentObject = z.object({
    someKey: z.string().optional()
  })
  
  const zodChildObject = zodParentObject.extend({
    someChildKey: z.string().default((ctx) => ctx.parent.someKey ?? "fallback-value")
  })
  

验证效果示例 #

// 解析时自动填充someChildKey为someKey的值
const parsed = zodChildObject.parse({ someKey: "hello-zod" })
console.log(parsed) 
// 输出：{ someKey: "hello-zod", someChildKey: "hello-zod" }

注意点 #

• 优先使用extend而不是merge：extend是在已有对象schema上追加字段，和Joi的keys()行为完全匹配；merge是合并两个独立schema，语义上更适合组合不同的对象结构。
• 函数式默认值是在验证阶段动态计算的，和Joi.ref()的运行时求值逻辑一致。

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