HttpResponseException中错误消息不显示问题排查求助

1. 异常类构造函数逻辑错误 #

你在AppException的构造函数中直接抛出HttpResponseException，这会导致实际抛出的异常是HttpResponseException而非AppException，嵌套抛出的方式打乱了异常传递流程。更关键的是，ASP.NET Core框架默认不处理HttpResponseException（该类型已被标记为过时），因此即使设置了响应内容，框架也不会将其返回给客户端。

2. 框架对过时异常类型的处理限制 #

旧版ASP.NET Web API会自动解析HttpResponseException并返回带内容的响应，但ASP.NET Core移除了这一默认逻辑。未被框架识别的异常只会触发默认错误处理，仅返回状态码，不会携带自定义消息。

3. 控制器未处理自定义异常 #

你的控制器直接调用服务层方法，没有捕获并转换自定义异常为标准ActionResult。当异常未被处理时，框架默认异常中间件仅返回基础状态码响应，丢弃了异常中的消息内容。

第一步：重构自定义异常类 #

移除构造函数内的异常抛出逻辑，让AppException成为携带状态码和消息的普通自定义异常：

public class AppException : Exception
{
    public HttpStatusCode StatusCode { get; }

    public AppException(HttpStatusCode statusCode, string message) 
        : base(message)
    {
        StatusCode = statusCode;
    }
}

第二步：全局处理自定义异常（推荐） #

创建异常过滤器，统一处理AppException并返回带消息的响应：

public class AppExceptionFilter : IExceptionFilter
{
    public void OnException(ExceptionContext context)
    {
        if (context.Exception is AppException appEx)
        {
            context.Result = new ObjectResult(new { ErrorMessage = appEx.Message })
            {
                StatusCode = (int)appEx.StatusCode
            };
            context.ExceptionHandled = true;
        }
    }
}

在Program.cs中注册过滤器：

builder.Services.AddControllers(options =>
{
    options.Filters.Add<AppExceptionFilter>();
});

第三步：（可选）控制器内捕获异常 #

如果不想全局处理，也可以在控制器方法中直接捕获异常并返回响应：

[HttpPost]
[ProducesResponseType(StatusCodes.Status201Created)]
[ProducesResponseType(StatusCodes.Status400BadRequest)]
[ProducesResponseType(StatusCodes.Status500InternalServerError)] // 添加对应状态码的响应声明
public async Task<ActionResult<User>> CreateAsync(User user)
{
    if (!ModelState.IsValid)
    {
        return BadRequest(ModelState);
    }

    try
    {
        var result = await _userService.CreateAsync(user);
        return Ok(result);
    }
    catch (AppException ex)
    {
        return StatusCode((int)ex.StatusCode, new { ErrorMessage = ex.Message });
    }
}

小优化：修复服务层字符串格式化 #

服务层中string.Format和$符号重复使用，可简化为：

var message = $"User with email={user.Email} already exists.";

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