在IIS 8.5中调用带JWT的C# WebAPI时提示‘An error has occurred’

一、IIS 8.5核心配置调整 #

• 安装必备IIS组件：确保服务器已安装ASP.NET 4.5（匹配WebAPI的.NET版本）、URL Rewrite、ISAPI Extensions和ISAPI Filters组件。通过服务器管理器的「添加角色和功能」，在「应用程序开发」分类下勾选对应项。
• 调整应用程序池设置：将应用程序池的.NET Framework版本设为WebAPI依赖的版本（如4.5+），托管管道模式改为集成——经典模式会导致管道处理异常，JWT验证中间件无法正常工作。
• 开启详细错误显示：在站点的「错误页」功能中，编辑功能设置，将错误响应改为「详细错误」，替换默认的模糊提示“An error has occurred”，以便查看具体异常信息。
• 放宽请求筛选限制：JWT Token长度可能超出IIS默认限制，在「请求筛选」的编辑功能设置中，调大Maximum allowed content length（建议设为10MB）和Maximum request headers size（建议设为64KB）。

二、WebAPI应用程序配置优化 #

• 对齐依赖库版本：检查System.IdentityModel.Tokens.Jwt、Microsoft.Owin.Security.Jwt等JWT相关库的版本，确保兼容.NET Framework 4.5（Windows Server 2012 R2默认版本）。若依赖高版本.NET，可升级服务器的.NET Framework至4.6.2及以上（推荐，4.5已停止支持）。
• 修正JWT验证逻辑：
  • 验证Startup.cs中JWT中间件的配置，确保TokenValidationParameters的IssuerSigningKey、ValidateIssuerSigningKey等参数设置正确，避免密钥格式错误导致未捕获异常。
  • 调整中间件顺序，确保UseJwtBearerAuthentication在UseWebApi之前；若全局注册了验证过滤器，需确认[AllowAnonymous]特性能正常跳过验证逻辑。
• 开启应用程序详细日志：在Web.config中添加以下配置，获取更详细的错误堆栈：

<system.web>
  <customErrors mode="Off"/>
</system.web>
<system.webServer>
  <httpErrors errorMode="Detailed"/>
</system.webServer>
<system.diagnostics>
  <sources>
    <source name="System.Web" switchName="All"/>
    <source name="Microsoft.Owin" switchName="All"/>
  </sources>
  <switches>
    <add name="All" value="Verbose"/>
  </switches>
  <trace autoflush="true"/>
</system.diagnostics>

之后可在事件查看器的「Windows日志→应用程序」中查看具体异常信息。

三、本地localhost调用返回空下载文件的修复 #

• 配置正确的MIME类型：IIS 8.5默认未映射application/json类型，导致浏览器将响应识别为未知文件。在站点的「MIME类型」中添加：扩展名.json，MIME类型application/json。
• 验证路由配置：检查WebApiConfig.cs中的路由模板，确保GET接口的[HttpGet]特性与路由规则匹配，避免路由匹配错误返回空响应。

四、其他排查要点 #

• 权限检查：确保应用程序池标识（如ApplicationPoolIdentity）拥有WebAPI文件目录的读取权限，若使用证书存储JWT密钥，需给应用程序池分配证书读取权限。
• 启用TLS 1.2：若WebAPI使用HTTPS，IIS 8.5默认禁用TLS 1.2，可能导致JWT验证失败。通过注册表启用：
  • 定位到HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\SecurityProviders\SCHANNEL\Protocols\TLS 1.2\Client，新建DWORD值Enabled并设为1；同理在Server项中设置相同值。
  • 重启服务器生效。

内容的提问来源于stack exchange，提问作者Daniel Sousa Lima