文档中心

探索 DWeb 框架的无限可能，构建下一代高性能 Web 应用

errorHandler - 错误处理

errorHandler 中间件统一处理应用错误，提供友好的错误响应。

基本使用

Code
import { errorHandler } from '@dreamer/dweb';

server.use(errorHandler({
  format: 'json', // 'json' | 'html' | 'text'
  includeStack: Deno.env.get('DENO_ENV') === 'development',
}));

配置选项

可选参数

  • debug - 是否在开发环境中显示详细错误信息（默认 true）
  • formatError - 自定义错误格式化函数，接收错误对象和请求对象，返回格式化后的错误信息对象（包含 error, message, statusCode, details）
  • onError - 错误日志记录函数，接收错误对象和请求对象
  • defaultMessage - 默认错误消息（当无法获取错误消息时使用）
  • logStack - 是否记录错误堆栈（默认在开发环境中记录）
  • skip - 跳过错误处理的路径数组（支持 glob 模式）