如何从AJV输出中提取属性名，将验证错误映射为友好提示信息？

我完全理解你不想针对每个错误类型（比如required、type）单独写判断逻辑的需求。虽然AJV不同错误类型的属性名存储位置确实有差异，但我们可以封装一个通用工具函数来统一处理，让你在业务代码里不用关心内部的判断细节。

通用属性名提取函数 #

下面这个函数可以覆盖绝大多数常见的AJV错误场景，自动识别属性名的位置：

import { DefinedError } from 'ajv';

function getValidationProperty(err: DefinedError): string {
  // 处理必填项缺失的错误（required关键字）
  if (err.keyword === 'required') {
    return err.params.missingProperty;
  }
  // 处理字段类型/格式类错误（属性名在instancePath中，去掉开头的斜杠即可）
  if (err.instancePath && err.instancePath.startsWith('/')) {
    return err.instancePath.slice(1);
  }
  // 处理额外属性的错误（additionalProperties关键字）
  if (err.keyword === 'additionalProperties') {
    return err.params.additionalProperty;
  }
  // 罕见错误类型的 fallback，可根据需求调整
  return '';
}

改造你的验证中间件 #

把上面的函数集成到你的中间件里，就能直接将AJV的错误数组映射成你想要的格式：

// 建议把编译好的验证函数缓存起来，避免每次请求重复编译
const validateLeaderboardQuery = ajv.compile<ILeaderboardQuery>(LeaderboardQuerySchema);

export const GetLeaderboardValidator = (req: Request, res: Response, next: NextFunction) => {
  const isValid = validateLeaderboardQuery(req.query); // 这里根据你实际验证的参数位置调整，比如req.body

  if (!isValid && validateLeaderboardQuery.errors) {
    const formattedErrors = validateLeaderboardQuery.errors.map(err => ({
      property: getValidationProperty(err),
      message: err.message || 'Validation error'
    }));
    
    // 返回格式化后的错误响应
    return res.status(400).json({ errors: formattedErrors });
  }

  next();
};

额外优化说明 #

我还帮你做了一个性能优化：把ajv.compile的结果提到中间件外面缓存起来，不用每次请求都重新编译Schema，这在高并发场景下能明显提升API性能。

这个方案覆盖了日常开发中最常见的验证错误场景，后续如果遇到特殊的错误类型，只需要在getValidationProperty函数里扩展对应的判断逻辑即可，业务代码完全不用改动。

内容的提问来源于stack exchange，提问作者Kay