hyperf需自定义异常处理器以规避安全风险并提升体验：继承exceptionhandler重写handle和isvalid方法，按环境控制错误信息粒度（生产环境仅返回message和error_id），统一json响应结构并记录日志，最后在exceptions.php中注册且禁用默认处理器。

<p>Hyperf 默认的异常处理器会把错误堆栈等敏感信息直接返回给前端，存在安全风险，也影响用户体验。需要自定义异常处理器，统一格式、过滤敏感内容、区分环境返回不同信息。</p>

<h3>创建自定义异常处理器</h3>
<p>继承 <strong>Hyperf\ExceptionHandler\ExceptionHandler</strong>，重写 <strong>handle</strong> 和 <strong>isValid</strong> 方法：</p>

• handle：负责构造响应体，调用 $response->withStatus(500)->json([...])
• isValid：决定该处理器是否处理当前异常类型（例如只处理 Throwable 或自定义业务异常）
• 建议按异常类型分层处理：系统级异常（如 PDOException）返回通用提示；业务异常（如 BusinessException）透出 message；开发环境可额外携带 trace

按环境控制错误信息粒度

通过 env() 判断当前环境，动态调整返回内容：

PigX UI 前端开发

PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。

下载

• 生产环境：只返回 message 和唯一 error_id（用于日志追溯），绝不暴露文件路径、行号、数据库语句、配置项
• 测试/预发环境：可增加简略 trace（如前 3 行），或添加 debug: true 标识便于排查
• 本地开发环境：允许完整 trace、上下文变量（需确保不输出密码、token 等敏感字段）

统一响应结构并记录日志

返回 JSON 响应时，保持与正常接口一致的数据结构，例如：

• {"code": 500, "message": "服务器开小差了", "data": null, "error_id": "err_abc123"}
• 在 handle 中同步调用 LoggerInterface 记录完整异常（含 trace、请求 URI、用户 ID 等上下文）
• 为每个异常生成唯一 error_id（可用 uniqid('err_')），方便前后端联查日志

注册到 DI 容器并禁用默认处理器

在 config/autoload/exceptions.php 中注册：

• 将自定义处理器类加入 handlers 数组，并设置 priority 高于默认处理器（如设为 100）
• 确保默认的 Hyperf\ExceptionHandler\ExceptionHandler 不再生效（可通过注释或移除其配置）
• 如使用 Swoole HTTP 服务，确认未在 onError 回调中重复输出错误

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！