Blazor WSAM Host（独立账户）发布至IIS后HTTP 500错误排查

• 修正数据库连接字符串
  本地开发常用的LocalDB无法在IIS服务器上正常运行，需将appsettings.json中的ConnectionStrings:DefaultConnection替换为服务器上SQL Server的有效连接字符串，例如：

  "ConnectionStrings": {
    "DefaultConnection": "Server=你的数据库服务器地址;Database=你的数据库名;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
  

  同时确保IIS应用池对应的账户拥有该数据库的读写权限。

• 配置IIS应用池

  • 将应用池的.NET CLR版本设置为无托管代码（适配ASP.NET Core项目）；
  • 若使用ApplicationPoolIdentity，需为该身份分配数据库访问权限及站点物理路径的读写权限；调试阶段可临时切换为LocalSystem（不推荐生产环境使用）以快速验证权限问题。

• 配置HTTPS与身份验证参数

  • 在IIS站点绑定有效的SSL证书，开启HTTPS访问；
  • 更新appsettings.json中的身份验证配置，将Authentication:Schemes:Bearer:Authority改为服务器的HTTPS域名（如https://你的域名.com），确保与前端请求的地址一致；同时确认Audience参数与后端配置匹配。

• 确保数据库迁移完成
  不要仅在本地执行update-database，需在服务器环境下针对发布后的数据库连接字符串执行迁移命令，或在VS发布时勾选“执行Code First迁移”选项，确保服务器上的数据库结构与本地一致。

• 配置静态文件与权限

  • 确认Program.cs中已包含app.UseStaticFiles();中间件，保证Blazor WASM的静态资源可正常访问；
  • 为IIS站点的物理路径分配应用池账户的读写权限，避免静态文件无法加载或缓存写入失败。

• 开启详细错误排查

  • 在appsettings.json中调整日志级别，开启Debug日志：

    "Logging": {
      "LogLevel": {
        "Default": "Debug",
        "Microsoft.AspNetCore": "Debug"
      }
    }
    

  • 在IIS站点的“错误页”设置中，开启“详细错误”，以便查看500错误的具体原因，快速定位问题。

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