Hyperf 默认接口错误返回 JSON，需启用 view 组件并自定义 ValidationExceptionHandler 才能渲染 HTML 错误页；配置时须按 server name（如 http）在 exceptions.php 中注册处理器，且注意大小写敏感。
Hyperf 默认不启用视图引擎，接口返回错误时通常直接输出 JSON（如 422 状态 + errors 字段），而不是渲染 HTML 页面。若你希望在开发阶段让验证失败、异常等以更直观的视图形式展示（比如带堆栈、字段错误列表的网页），需主动启用并配置视图组件，并替换默认的异常响应逻辑。
启用视图组件并配置模板引擎
Hyperf 官方推荐使用 Twig 或 Blade（通过 hyperf/view 组件）。以 Twig 为例：
- 执行
composer require hyperf/view - 发布配置：
php bin/hyperf.php vendor:publish hyperf/view - 确认
config/autoload/view.php中已启用引擎，且template_path指向存在的目录（如storage/views） - 在该目录下新建
error.blade.php或validation_error.twig，用于渲染错误信息
拦截验证异常并渲染视图
默认的 ValidationExceptionHandler 返回纯 JSON，要改用视图，需自定义异常处理器：
- 新建类
App\Exception\RenderValidationExceptionHandler，实现ExceptionHandlerInterface - 在
handle()方法中，判断是否为ValidationException - 调用
$throwable->validator->errors()->messages()获取全部错误 - 使用
$this->container->get(RendererInterface::class)->render('validation_error', ['errors' => $messages])渲染模板 - 返回
$response->withStatus(422)->withBody(...)，body 为渲染后的 HTML 内容
注册到 exceptions.php 并确保生效
关键点在于 handler 键名必须与 server name 严格一致：
- 运行
php bin/hyperf.php start，查看日志中 HTTP server 的 name（如[INFO] Server started: http://0.0.0.0:9501 (name: http)） - 打开
config/autoload/exceptions.php，在'handler'数组中添加对应键：'http' => [App\Exception\RenderValidationExceptionHandler::class] - 若 server name 是
api，此处就必须写'api'，大小写敏感，否则不会触发 - 删除
runtime/container缓存后重启服务，确保新配置加载
补充：调试时快速查看原始错误
开发阶段可临时加一个路由，手动触发并渲染错误，便于验证视图逻辑是否正常：
- 在控制器中模拟一个验证失败：
$validator = $this->validationFactory->make($data, ['email' => 'required|email']); $validator->validate(); - 捕获
ValidationException后，直接调用渲染逻辑并返回响应 - 这样能绕过全局异常流程，快速验证模板路径、变量传递、CSS 样式等是否就位
