Zod自定义类型验证报错：输入无效，如何获取详细错误信息？

看起来你遇到的这个模糊的"Invalid input"错误，大概率是因为没有正确获取Zod返回的完整错误结构，或者错误处理的方式不对。我来帮你一步步排查和解决：

首先，先搞懂为什么会出现这个空路径的模糊错误 #

Zod在验证失败时，会返回包含详细问题的issues数组，但如果你用了parse方法（验证失败直接抛出异常），并且上层错误处理只捕获了顶层的错误消息，就会得到这种笼统的提示。另外，也有可能是你没有正确访问错误对象里的详细字段。

解决第一步：改用safeParse获取完整错误详情 #

Zod的safeParse方法是处理验证的推荐方式——它不会抛出异常，而是返回一个包含success状态的对象，验证失败时可以通过result.error.issues拿到所有字段的具体错误信息。

举个实际的使用例子：

// 假设这是你的表单数据
const formData = {
  // 模拟几个不符合规则的场景
  title: "", // 违反必填规则
  skills_required: [], // 违反至少一个技能的要求
  min_year_of_experience: "5",
  max_year_of_experience: "2" // 违反min<=max的refine规则
};

// 用safeParse做验证
const validationResult = postJobSchema.safeParse(formData);

if (!validationResult.success) {
  // 打印完整的错误数组，这里能看到每个错误的字段、消息和类型
  console.log("详细错误列表：", validationResult.error.issues);
  
  // 也可以把错误转成按字段分组的格式，方便前端展示
  const fieldErrors: Record<string, string> = {};
  validationResult.error.issues.forEach(issue => {
    const fieldName = issue.path.join('.'); // 数组路径转成字符串，比如"max_year_of_experience"
    fieldErrors[fieldName] = issue.message;
  });
  console.log("按字段整理的错误：", fieldErrors);
} else {
  // 验证成功，处理你的业务逻辑
  console.log("有效数据：", validationResult.data);
}

运行这段代码后，你会得到类似这样的详细输出：

详细错误列表： [
  {
    code: 'invalid_type',
    path: [ 'title' ],
    message: 'Job Title should not be empty',
    expected: 'string',
    received: 'string'
  },
  {
    code: 'too_small',
    path: [ 'skills_required' ],
    message: 'At least one skill is required',
    minimum: 1,
    type: 'array'
  },
  {
    code: 'custom',
    path: [ 'max_year_of_experience' ],
    message: 'Max year of experience should be greater than or equal to min year of experience'
  }
]
按字段整理的错误： {
  title: 'Job Title should not be empty',
  skills_required: 'At least one skill is required',
  max_year_of_experience: 'Max year of experience should be greater than or equal to min year of experience'
}

额外排查点：检查你的refine逻辑是否有隐藏问题 #

看了你的schema里的三个refine规则，设置的path都是正确的，但有个小细节要注意：

• 薪资验证的refine里，当min_offered_salary或max_offered_salary是无效数字（比如字符串"abc"）时，Number()会返回NaN，这时候NaN <= 任何数都是false，会触发薪资的refine错误。如果遇到这种情况，你可以在refine里先判断是否是有效数字，比如：

.refine((data) => {
  if (data.min_offered_salary && data.max_offered_salary) {
    const min = Number(data.min_offered_salary);
    const max = Number(data.max_offered_salary);
    // 先判断是否是有效数字
    if (isNaN(min) || isNaN(max)) return false;
    return min <= max;
  }
  return true; 
}, {
  path: ["max_offered_salary"],
  message: "Max offered salary should be greater than or equal to min offered salary (and both must be valid numbers)",
})

总结一下你需要做的 #

1. 把原来的parse方法全部换成safeParse，避免异常抛出导致的错误信息丢失；
2. 直接访问result.error.issues数组，这里才是Zod返回的所有详细错误；
3. 用console.log打印issues，就能看到每个错误对应的字段、消息和类型，完全替代那个模糊的"Invalid input"提示。

备注：内容来源于stack exchange，提问作者itsAPK