ASP.NET WebApi部署服务器遇500错误，HttpContext.Current.Request引发问题

为什么会出现这个问题？ #

HttpContext.Current是静态对象，在ASP.NET Web API的一些场景里（比如异步控制器、脱离请求上下文的代码块）很可能为null。本地调试时因为上下文保留机制，这个值大概率一直存在，但服务器的生产环境（比如多线程处理、应用池配置差异）会把这个隐藏的问题暴露出来，而且这种底层异常有时候会绕过try-catch，直接触发500错误。

具体修复步骤 #

• 换掉HttpContext.Current的写法：
  Web API本身就给控制器提供了Request属性，直接用这个就行，别依赖静态的HttpContext.Current。把代码改成：

  var httpRequest = this.Request; // 控制器内部直接调用
  

  如果是在非控制器的类里需要请求信息，要么把HttpRequest对象作为参数传进去，要么用依赖注入的方式传递（比如ASP.NET Core里用IHttpContextAccessor，传统Web API可以考虑封装一个上下文传递的工具类）。

• 核对服务器应用池配置：

  • 确保服务器应用池的.NET版本和本地项目完全一致，比如本地用的是.NET 4.8，服务器不能选成4.5。
  • 检查托管管道模式：如果本地是集成模式，服务器也得设成集成模式；经典模式同理，模式不匹配会导致请求上下文异常。
  • 确认应用池的运行身份有足够权限，权限不足的时候访问Request对象可能触发未捕获的权限异常。

• 打开服务器的详细错误日志：
  既然本地的日志和try-catch没作用，直接在服务器的Web.config里开启详细错误输出，这样能看到具体的异常信息：

  <system.web>
    <customErrors mode="Off"/>
  </system.web>
  <system.webServer>
    <httpErrors errorMode="Detailed"/>
  </system.webServer>
  

  注意：调试完一定要改回RemoteOnly或者On，别把敏感错误信息暴露给外部。

• 检查异步代码的上下文问题：
  如果你的控制器方法是异步的，线程切换后HttpContext.Current会丢失上下文，这种情况必须用控制器自带的Request属性，或者在异步方法里手动保留请求上下文（不过更推荐前者，符合Web API的设计规范）。

额外提醒 #

依赖HttpContext.Current这种静态对象本身就属于不规范的写法，它会让代码和请求上下文强耦合，而且在多线程、负载均衡的环境下很容易出问题。尽量用Web API提供的实例属性或者依赖注入来获取请求信息，能避免很多这类部署后的奇怪问题。

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