Zod 如何正确获取数组内嵌套对象的详细校验错误信息-js教程

当使用 zod 校验包含对象数组的 schema 时，`flatten()` 默认无法展开嵌套字段错误；需改用 `format()` 方法或遍历 `issues` 数组，才能精准定位如 `sizes[0].price` 等深层字段的校验失败原因。

Zod 的 .flatten() 方法设计用于扁平化顶层字段的错误（如 “sizes” 缺失或类型错误），但它不会递归解析数组中每个对象内部字段的校验失败。因此，当你传入 sizes: [{}] 时，Zod 虽然检测到 price、off_price、sell_quantity 均缺失，但 e.flatten() 仅将这三条错误统一聚合为 fieldErrors.sizes = [“Required”, “Required”, “Required”]，丢失了关键的字段路径信息（如哪个字段缺失、在哪一个数组项中），极大降低调试与前端错误提示的准确性。

✅ 正确做法是使用 Zod 提供的结构化错误处理能力：

1. 使用 error.format() 获取嵌套字段级错误树

format() 返回一个深度嵌套的对象，精确映射原始数据结构，并在每个叶节点下以 _errors 数组存放该字段的错误消息：

const result = schema.safeParse({ sizes: [{}] });
if (!result.success) {
  const formatted = result.error.format();
  console.log(formatted.sizes?.[0]);
  // 输出：
  // {
  //   _errors: [],
  //   price: { _errors: ['Required'] },
  //   off_price: { _errors: ['Required'] },
  //   sell_quantity: { _errors: ['Required'] }
  // }
}

该结构天然适配前端表单：例如 React 中可直接通过 formatted.sizes?.[0]?.price?._errors 绑定到对应输入框下方的提示文案。