hyperf验证失败无errors字段的主因是server name配置错位或语言文件键名不匹配：需确保exceptions.php中handler键名与server.php中http server的name完全一致，并确认zh_cn/validation.php存在且错误键名匹配，否则errors将为空。
验证失败返回空响应或 422 但无 errors 字段
Hyperf 的 ValidationExceptionHandler 默认返回的 JSON 响应里包含 message（首个错误）和 errors（全部字段错误数组），但很多项目返回的却是空 errors 或根本没 errors 字段——这通常不是规则写错了，而是错误码映射配置缺失或错位导致异常被降级为通用响应。
config/autoload/exceptions.php 中的 handler 配置必须匹配 server name
Hyperf 根据 HTTP Server 的 name 字段决定用哪套异常处理器。若你在 config/autoload/server.php 中把 HTTP server 的 name 改成了 api，但 exceptions.php 里仍写的是：
'handler' => [ 'http' => [Hyperf\Validation\ValidationExceptionHandler::class], ]
那验证失败时根本不会走这个处理器，而是 fallback 到默认的 ExceptionHandler，它只返回 message 和状态码，不带 errors。
- 运行
php bin/hyperf.php start后看启动日志，确认 server name 是什么（如[INFO] Server started: http://0.0.0.0:9501对应的 name） - 检查
config/autoload/server.php中对应 server 的name值（默认是http，但常被改成api、admin等） -
exceptions.php的 key 必须完全一致，大小写敏感：比如 name 是api，就得写'api' => [...]
自定义异常处理器里没调用 $validator->errors() 就直接 return
很多人抄了官方示例但删掉了关键行，导致 response body 里只有 message，没有结构化 errors：
if ($throwable instanceof ValidationException) {
$this->stopPropagation();
// ❌ 错误：只取 first()，丢掉全部字段错误
$message = $throwable->validator->errors()->first();
return $response->withStatus(422)->withBody(new SwooleStream(json_encode(['message' => $message])));
}
正确做法是显式提取完整错误结构：
- 用
$throwable->validator->errors()->messages()获取关联数组（字段名 → 错误列表） - 或用
$throwable->validator->errors()->getMessages()（效果相同） - 注意：不要依赖
$throwable->getMessage()，它可能只是 “The given data was invalid.” 这类泛化提示
Language 文件未加载或键名不匹配导致 errors 字段为空
即使处理器逻辑正确，errors 数组也可能为空——常见于中文语言包未生效：
- 确认已执行
php bin/hyperf.php vendor:publish hyperf/validation - 检查
storage/languages/zh_CN/validation.php是否存在且内容不为空 - 规则中写的
'name.required' => '用户名不能为空'，但语言文件里 key 是'required'，没加字段前缀，会导致 message 渲染失败，进而影响 errors 输出逻辑 - 更稳妥的方式是在
FormRequest类中重写messages()方法，而非依赖全局语言包
真正容易被忽略的是：server name 配置错位和 language 文件中错误键名不匹配，这两处一出问题，errors 字段就静默消失，排查时容易陷入规则或中间件逻辑的死胡同。
