异常处理器 & 自动统一响应

Sharkable 内置了全局异常处理中间件，能将未处理的异常转换为统一的 UnifiedResult<T> JSON 响应，同时可选的自动包装过滤器能将端点返回值自动包装为 UnifiedResult<T>。

全局异常处理器

调用 app.UseShark() 时默认启用。会捕获端点和中间件中所有未处理的异常，映射为 HTTP 状态码，并返回 UnifiedResult<object?> JSON 响应。

默认状态码映射

异常类型	HTTP 状态码
KeyNotFoundException	404 Not Found
UnauthorizedAccessException	401 Unauthorized
ArgumentException	400 Bad Request
其他异常	500 Internal Server Error

响应格式

{
  "StatusCode": 404,
  "Data": null,
  "ErrorMessage": "user not found",
  "Extra": null,
  "TimeStamp": 1780881487673,
  "Result": null
}

在开发模式（ASPNETCORE_ENVIRONMENT=Development）下，错误信息会包含完整堆栈跟踪。

自定义错误映射

app.UseShark(opt => { });

// 或单独使用：
app.UseSharkExceptionHandler(opt =>
{
    opt.Map<MyCustomException>(HttpStatusCode.Forbidden);
});

禁用

app.UseShark(opt =>
{
    opt.EnableExceptionHandler = false;
});

自动 UnifiedResult 包装（可选）

开启后，返回值不是 IResult 的端点会被自动包装为 UnifiedResult<T>。

app.UseShark(opt =>
{
    opt.EnableAutoWrap = true;
});

// 之前：直接返回字符串
app.MapGet("hello", () => "world");

// 之后（开启 EnableAutoWrap）：
// 响应：{ "statusCode": 200, "data": "world", ... }

注意： 自动包装使用反射和 MakeGenericType — 在 AOT 模式下只有当你将具体的 UnifiedResult<T> 类型通过 [JsonSerializable] 注册到 JsonSerializerContext 中才能正常工作。