如何使用Zod创建包含静态字段与动态键的Schema？

云上老周

2026-7-30

用Zod实现固定字段+动态键的混合类型

要实现你需要的「既有固定静态字段，又支持任意动态string键（值为string）」的Zod Schema，有两种简洁的可行方式：

方法1：使用`catchall`（推荐）

Zod的ZodObject提供了catchall方法，可直接为对象中未定义的键设置统一校验规则，完美匹配你的需求：

import { z } from "zod";

const mixedSchema = z.object({
  name: z.string(),
  surname: z.string(),
}).catchall(z.string());

// 推导的类型完全符合预期：
type MixedType = z.infer<typeof mixedSchema>;
// 等价于：
// type MixedType = {
//   [key: string]: string;
//   name: string;
//   surname: string;
// }

方法2：使用`z.intersection`

如果需要分开定义固定字段和动态规则，可以用z.intersection将ZodObject和ZodRecord交叉合并：

import { z } from "zod";

const fixedFieldsSchema = z.object({
  name: z.string(),
  surname: z.string(),
});

const dynamicFieldsSchema = z.record(z.string());

const mixedSchema = z.intersection(fixedFieldsSchema, dynamicFieldsSchema);

// 推导的类型同样满足需求
type MixedType = z.infer<typeof mixedSchema>;