当使用 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 绑定到对应输入框下方的提示文案。
2. 使用 error.issues 手动提取完整上下文
若需自定义错误聚合逻辑（如生成用户友好的汇总提示），推荐遍历 issues 数组——它包含每条错误的完整元数据：
if (!result.success) {
const nestedErrors = result.error.issues
.filter(issue => issue.path.length >= 3 && issue.path[0] === 'sizes')
.map(issue => ({
index: issue.path[1] as number,
field: issue.path[2] as string,
message: issue.message,
code: issue.code,
}));
console.log(nestedErrors);
// [
// { index: 0, field: 'price', message: 'Required', code: 'invalid_type' },
// { index: 0, field: 'off_price', message: 'Required', code: 'invalid_type' },
// { index: 0, field: 'sell_quantity', message: 'Required', code: 'invalid_type' }
// ]
}⚠️ 注意事项：
- 避免在 Schema 中对嵌套字段重复使用 .nonempty()（如 z.string().nonempty()）——Zod 的 string() 默认已要求非空（即不能为 "" 或 undefined），.nonempty() 实际上是冗余的，且可能掩盖更精细的错误类型（如空字符串 vs 完全缺失）。如需区分，建议显式使用 z.string().min(1) 或自定义 refine。
- 若需国际化支持，issues 中的 message 字段可被覆盖（配合 z.setErrorMap），而 format() 的输出会自动应用该映射。
- format() 对大型数组性能开销略高，生产环境高频调用时建议结合 issues 做按需解析。
总结：要真正“看到”数组内对象的字段级错误，放弃 flatten()，拥抱 format() 或 issues——这是 Zod 类型安全与开发者体验兼顾的核心实践。
