.NET 6 WebAPI强类型方法如何返回403状态码且不破坏强类型

核心实现方案：使用Minimal API原生泛型联合类型 #

.NET 6 及以上版本的Minimal API原生提供了Results<T1, T2...>泛型类型，可在不破坏强类型约束的前提下，支持单个接口返回多种类型的响应结果，完全不需要手动操作IHttpContextAccessor构造响应。

实现步骤 #

• 第一步：定义你的正常返回类型、自定义错误类型（如果需要）

// 原有正常返回的自定义数据记录
public record MyDataRecord(int Id, string Content);

// 自定义403错误返回结构
public record ApiError(string ErrorCode, string ErrorMsg);

• 第二步：修改接口返回值为联合类型，使用TypedResults返回对应响应

app.MapGet("/api/your-endpoint", () => Results<Ok<MyDataRecord>, Forbid<ApiError>>
{
    // 你的权限校验逻辑
    if (!CurrentUserHasPermission())
    {
        // 返回403状态码，同时携带自定义错误对象
        return TypedResults.Forbid(new ApiError("PERMISSION_DENIED", "您没有访问该资源的权限"));
    }

    // 正常返回业务数据
    return TypedResults.Ok(new MyDataRecord(1, "业务数据内容"));
});

方案优势 #

• 完全符合强类型要求：编译器会强制校验接口只能返回定义范围内的响应类型，不会出现非法返回值
• 框架自动处理序列化、状态码设置，无需手动操作HTTP上下文
• 自动适配Swagger/OpenAPI文档生成，无需额外添加响应类型注解，两种返回结构会自动同步到接口文档中
• 扩展灵活：如果需要支持更多状态码（比如404、500），只需要在泛型参数中追加对应的响应类型即可

注意事项 #

如果返回403时没有正常输出自定义内容，可检查是否配置了全局的认证响应拦截逻辑，覆盖了接口返回的内容。

内容的提问来源于stack exchange，提问作者Seva Alekseyev