ASP.NET Core 8 Web API异常消息不显示及响应Base64编码问题求助

问题1：控制器抛出BadHttpRequestException后响应体为空，异常消息未显示 #

原因 #

1. 你移除了默认的异常处理中间件（UseDeveloperExceptionPage和UseExceptionHandler），ASP.NET Core出于安全考虑，默认不会将异常消息暴露到响应体中，避免泄露服务器内部细节。
2. BadHttpRequestException属于HTTP请求类异常，框架默认处理逻辑仅返回对应的400状态码，不会附加异常消息。

解决方法 #

• 开发环境：重新启用UseDeveloperExceptionPage，可在响应中查看完整异常详情：

  if (app.Environment.IsDevelopment())
  {
      app.UseDeveloperExceptionPage();
  }
  

• 生产环境：自定义异常处理逻辑，比如添加全局异常中间件，捕获异常并构造包含消息的响应（该中间件需放在UseRouting之前）：

  app.Use(async (context, next) =>
  {
      try
      {
          await next();
      }
      catch (BadHttpRequestException ex)
      {
          context.Response.StatusCode = StatusCodes.Status400BadRequest;
          context.Response.ContentType = "application/json";
          await context.Response.WriteAsJsonAsync(new { Message = ex.Message });
      }
  });
  

问题2：直接通过Response.WriteAsync写入的字符串被Base64编码 #

原因 #

1. 控制器方法声明返回ResultClass，ASP.NET Core默认按JSON格式处理响应，手动写入Response会与框架的内容协商机制冲突，导致内容被错误编码。
2. 直接写入响应时未明确设置Content-Type，框架默认将内容视为二进制流，自动执行Base64编码。

解决方法 #

• 推荐方案：避免混合使用控制器返回类型与手动写入操作，改用IActionResult返回指定状态码和消息：

  [HttpGet]
  [Route("whatever/endpoint2")]
  public IActionResult GetStuff(string query) 
  {
      return StatusCode(StatusCodes.Status500InternalServerError, "This is an error");
  }
  

• 若必须手动写入响应：明确设置Content-Type，并返回EmptyResult告知框架已完成响应处理：

  [HttpGet]
  [Route("whatever/endpoint2")]
  public async Task<IActionResult> GetStuff(string query) 
  {
      Response.StatusCode = StatusCodes.Status500InternalServerError;
      Response.ContentType = "text/plain";
      await Response.WriteAsync("This is an error", System.Text.Encoding.ASCII);
      return new EmptyResult();
  }
  

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