Hyperf验证失败无errors字段主因是server name与exceptions.php中handler键名不匹配，需确保二者完全一致且大小写敏感；协程报错堆栈丢失须启用LineFormatter的include_stacktraces并注入correlation_id；日志混乱需手动传入cid和request_id。
Hyperf 3.1项目上线后验证失败却只返回空errors字段、协程报错堆栈消失、日志里找不到对应请求上下文——这类问题在面试中高频出现，本质不是代码写错，而是异常处理器配置错位或日志上下文未注入。
验证失败无errors字段：检查server name与handler映射
第一步：运行php bin/hyperf.php start，观察启动日志中[INFO] Server started: http://0.0.0.0:9501对应的name值（如api或http）。
第二步：打开config/autoload/server.php，找到HTTP server配置块，确认'name' => 'xxx'的值（默认是http，但常被改成admin、api等）。
第三步：打开config/autoload/exceptions.php，检查'handler'数组的键名是否与上一步的name值【完全一致、大小写敏感】。例如server name是api，就必须写'api' => [Hyperf\Validation\ValidationExceptionHandler::class]，不能写'http'或'API'。
第四步：若使用了自定义ValidationExceptionHandler，确认其中调用了$throwable->validator->errors()->messages()，而不是仅取first()——否则response body里只有message，没有结构化errors字段。
协程报错堆栈丢失：启用协程上下文日志增强
方法一：修改config/autoload/logger.php，在'formatter' => Monolog\Formatter\LineFormatter::class的'constructor'中，将第四个参数设为true（启用include_stacktraces），第五个参数也设为true（启用allow_inline_line_breaks）。
方法二：在业务控制器中，于请求入口处手动注入协程标识：\Hyperf\Context\Context::set('correlation_id', uniqid('req_'))；再在自定义Formatter中通过\Hyperf\Context\Context::get('correlation_id')读取并写入日志行首。
注意：不要依赖全局$_SERVER或$GLOBALS，协程环境下它们无法隔离上下文，会导致日志混杂。
日志找不到请求轨迹：强制绑定协程ID与请求ID
直接在日志打印前拼接协程ID和请求ID：$this->logger->info('user login start', ['cid' => \Swoole\Coroutine::getCid(), 'rid' => $request->getAttribute('request_id') ?? 'unknown']);
这一步操作起来很简单，直接把协程ID和请求ID作为上下文字典传入info()方法即可。如果没传，多协程并发时所有日志会挤在同一行，根本无法区分哪条日志属于哪个请求。
Hyperf默认不自动注入request_id，需确认中间件已启用Hyperf\HttpServer\Middleware\RequestIdMiddleware，且其配置项'length' => 13未被注释或覆盖。
