ASP.NET Core通过RFC 7807规范实现标准化错误响应，支持自动与手动返回application/problem+json格式的结构化错误信息。在Program.cs中配置ApiBehaviorOptions和UseExceptionHandler可启用默认错误处理机制，控制器中可直接使用Problem()、ValidationProblem()或自定义ProblemDetails派生类返回详细错误，便于客户端解析与统一处理。
在 ASP.NET Core 中，问题详细信息（Problem Details）服务用于标准化错误响应格式，遵循 RFC 7807 规范。它让 API 返回结构化的错误信息，便于客户端解析和处理。
启用问题详细信息服务
ASP.NET Core 默认支持问题详细信息，尤其是在开发环境中。当你抛出异常或返回特定状态码时，框架可自动返回 application/problem+json 格式的响应。
要确保启用该功能，在 Program.cs 中配置：
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllers();
// 启用问题详细信息作为默认错误响应
builder.Services.Configure<ApiBehaviorOptions>(options =>
{
options.InvalidModelStateResponseFactory = context =>
{
var problemDetails = new ValidationProblemDetails(context.ModelState)
{
Type = "https://tools.ietf.org/html/rfc7231#section-6.5.1",
Title = "One or more validation errors occurred.",
Status = StatusCodes.Status400BadRequest,
Detail = "请检查请求数据是否符合要求。",
Instance = context.HttpContext.Request.Path
};
return new BadRequestObjectResult(problemDetails);
};
});
var app = builder.Build();
app.UseExceptionHandler(exceptionHandlerApp =>
{
exceptionHandlerApp.Run(async context =>
{
context.Response.StatusCode = StatusCodes.Status500InternalServerError;
context.Response.ContentType = "application/problem+json";
var problemDetails = new ProblemDetails
{
Status = StatusCodes.Status500InternalServerError,
Title = "An unexpected error occurred.",
Type = "https://tools.ietf.org/html/rfc7231#section-6.6.1",
Detail = "请联系系统管理员或稍后重试。"
};
#if DEBUG
problemDetails.Extensions["traceId"] = context.TraceIdentifier;
problemDetails.Extensions["message"] = context.Features.Get<IExceptionHandlerFeature>()?.Error.Message;
#endif
await context.Response.WriteAsJsonAsync(problemDetails);
});
});
app.UseHttpsRedirection();
app.MapControllers();
app.Run();
手动返回问题详细信息
你可以在控制器中直接使用 Problem()、ValidationProblem() 或构造 ProblemDetails 对象返回标准错误响应。
[HttpGet("error")]
public IActionResult TriggerError()
{
return Problem(
detail: "数据库连接失败。",
title: "服务暂时不可用",
statusCode: StatusCodes.Status503ServiceUnavailable,
type: "https://example.com/errors/db-connection-failed",
instance: Request.Path);
}
验证失败时返回问题详情
[HttpPost]
public IActionResult Create([FromBody] MyModel model)
{
if (!ModelState.IsValid)
{
return ValidationProblem();
}
// 处理逻辑
return Ok();
}
自定义问题详情类型
你可以继承 ProblemDetails 添加额外字段，比如错误代码或建议操作。
public class CustomProblemDetails : ProblemDetails
{
public string ErrorCode { get; set; }
public string[] Suggestions { get; set; }
}
使用方式：
return new ObjectResult(new CustomProblemDetails
{
Status = 400,
Title = "输入参数错误",
Detail = "邮箱格式不正确",
ErrorCode = "INVALID_EMAIL",
Suggestions = new[] { "检查邮箱拼写", "使用有效域名" },
Instance = Request.Path
})
{
StatusCode = 400
};
基本上就这些。通过合理使用问题详细信息，你的 API 错误会更清晰、统一，也更容易被前端或第三方系统处理。 
