返回TypedResults.BadRequest<string>时ProblemDetails失效问题咨询

问题场景 #

你在ASP.NET Core 8中配置了ProblemDetails，但第三个端点返回的是字符串而非标准ProblemDetails格式：

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddProblemDetails();
var app = builder.Build();

app.UseExceptionHandler();
app.UseStatusCodePages();

// 返回标准ProblemDetails
app.MapGet("/400", () => TypedResults.BadRequest());
// 返回标准ProblemDetails
app.MapGet("/exception", () =>
{
    throw new Exception("Exception!");
});

// 仅返回字符串"Hello"，而非带Detail的ProblemDetails
app.MapGet("/400/hello", () => TypedResults.BadRequest("Hello"));

app.Run();

原因分析 #

核心差异在于TypedResults.BadRequest的不同重载行为：

• 非泛型重载TypedResults.BadRequest()：返回BadRequestResult，这是一个仅包含状态码的结果。ASP.NET Core的ProblemDetails中间件会识别这类无响应体的状态码结果，自动生成并返回标准ProblemDetails格式。
• 泛型重载TypedResults.BadRequest<T>(T value)：返回BadRequestObjectResult，其设计目的是直接将传入的T类型值作为响应体返回。当你传入字符串时，框架会直接输出该字符串，不会触发ProblemDetails中间件的封装逻辑——因为中间件只处理无响应体的状态码结果或未处理异常，不会覆盖你明确返回的响应内容。

解决办法 #

如果你需要将字符串消息封装到ProblemDetails中返回，有两种常用方式：

1. 手动构建ProblemDetails对象

app.MapGet("/400/hello", () => 
{
    var problemDetails = new ProblemDetails
    {
        Status = StatusCodes.Status400BadRequest,
        Title = "Bad Request",
        Detail = "Hello"
    };
    return TypedResults.BadRequest(problemDetails);
});

2. 使用Results.Problem快捷方法

app.MapGet("/400/hello", () => 
    Results.Problem(
        detail: "Hello",
        statusCode: StatusCodes.Status400BadRequest,
        title: "Bad Request"
    )
);

补充说明 #

ASP.NET Core的ProblemDetails中间件的触发逻辑是：

• 捕获未处理的异常，生成ProblemDetails响应
• 处理无响应体的状态码结果（如BadRequest()、NotFound()等非泛型重载），生成ProblemDetails响应
• 对于你明确返回的具体对象（如字符串、自定义DTO等），框架会直接返回该对象，不会进行额外封装。

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