当使用 zod 校验包含对象数组的结构（如 `sizes: [{ price, off_price, sell_quantity }]`）时，若数组元素缺失必填字段，`.flatten()` 默认无法展开嵌套路径错误；需改用 `.format()` 或遍历 `.issues` 才能精准定位到 `sizes[0].price` 等具体字段错误。
Zod 的 .flatten() 方法设计用于扁平化顶层字段错误（如 "sizes" 本身为空），但对数组内嵌套对象的字段级错误（如 sizes[0].price）默认不递归展开——这正是你遇到 "sizes":["Required","Required","Required"] 这类模糊提示的根本原因。
要真正暴露每一项的细粒度错误，推荐以下两种专业方案：
✅ 方案一：使用 .format() 获取结构化嵌套错误（推荐）
.format() 返回一个与原始数据结构对齐的错误树，天然支持数组索引和对象键路径：
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'] }
// }
}? 提示：.format() 支持深度嵌套，适用于任意层级（如 sizes[0].variants[1].sku），且返回值类型安全（TypeScript 可推导）。
✅ 方案二：手动解析 .issues 获取完整路径与上下文
当需要自定义错误聚合逻辑（如生成 i18n 错误消息或上报日志）时，直接操作 issues 数组更灵活：
if (!result.success) {
const fieldErrors: Record = {};
for (const issue of result.error.issues) {
// 构建可读字段路径：sizes.0.price → "sizes[0].price"
const path = issue.path.map((p, i) =>
typeof p === 'number' ? `[${p}]` : i === 0 ? p : `.${p}`
).join('');
fieldErrors[path] = fieldErrors[path] || [];
fieldErrors[path].push(issue.message);
}
console.log(fieldErrors);
// {
// "sizes[0].price": ["Required"],
// "sizes[0].off_price": ["Required"],
// "sizes[0].sell_quantity": ["Required"]
// }
} ⚠️ 注意事项
- 避免 .nonempty() 与字段级校验冲突：你原 schema 中 z.string().nonempty() 要求字符串非空，但若传入 ""，Zod 会报 "Expected string, received "" 而非 "Required"。如需严格“必填+非空”，建议拆分为 z.string().min(1) 或用 .refine() 增强语义。
- .strict() 影响错误位置：启用 .strict() 后，多余字段也会触发错误，但不影响字段级错误的提取逻辑。
- 生产环境建议封装工具函数：将 .format() 或 issues 解析逻辑封装为 getDetailedErrors(schema, data) 工具，统一处理表单级/字段级错误渲染。
通过以上方式，你不仅能精准捕获 sizes[0].price 的缺失，还能为前端表单动态高亮具体输入框，大幅提升用户体验与调试效率。
