IIS部署ASP.Net Core API连接SQL Server报500错误求助

1. 检查应用程序池身份配置 #

• IIS应用程序池若使用内置账户（如ApplicationPoolIdentity），访问SQL Server时会以IIS APPPOOL\<应用池名称>身份验证，而非你在sqlcmd中使用的SQL账户。
• 需确认SQL Server是否为该应用池身份创建登录名并分配权限，若未创建，执行以下SQL语句：

  CREATE LOGIN [IIS APPPOOL\<你的应用池名称>] FROM WINDOWS;
  USE UsersDatabase;
  CREATE USER [IIS APPPOOL\<你的应用池名称>] FOR LOGIN [IIS APPPOOL\<你的应用池名称>];
  GRANT SELECT, INSERT, UPDATE, DELETE ON users TO [IIS APPPOOL\<你的应用池名称>];
  

2. 验证Appsettings.json连接字符串 #

• 确保连接字符串的认证方式、用户名、密码与sqlcmd完全一致，SQL账户认证的连接字符串示例：

  "ConnectionStrings": {
    "DefaultConnection": "Server=<my domain>;Database=UsersDatabase;User Id=<userlogin>;Password=<password>;TrustServerCertificate=True;"
  }
  

• 排查拼写错误，注意SQL Server登录名的大小写（取决于服务器配置）。

3. 确认应用环境配置 #

• 检查IIS站点的ASPNETCORE_ENVIRONMENT环境变量，避免加载错误配置文件（如Appsettings.Development.json）。
• 在站点高级设置中添加环境变量，设置值为Production（或你实际使用的环境）。

4. 启用应用日志定位代码执行情况 #

• 在Program.cs中配置文件日志，确保日志能正常输出：

  var builder = WebApplication.CreateBuilder(args);
  // 添加文件日志
  builder.Logging.AddFile("Logs/app-{Date}.txt");
  // 其他服务配置
  var app = builder.Build();
  // 中间件配置
  app.Run();
  

• 给应用目录下的Logs文件夹分配应用池身份的读写权限。

5. 测试API内部数据库访问 #

• 添加测试接口，直接执行数据库查询并记录日志，确认代码是否执行到数据库访问环节：

  [HttpGet("test-db")]
  public async Task<IActionResult> TestDb()
  {
      try
      {
          using(var conn = new SqlConnection(Configuration.GetConnectionString("DefaultConnection")))
          {
              await conn.OpenAsync();
              var cmd = new SqlCommand("SELECT COUNT(*) FROM users", conn);
              var count = await cmd.ExecuteScalarAsync();
              return Ok($"用户数量：{count}");
          }
      }
      catch(Exception ex)
      {
          _logger.LogError(ex, "数据库测试失败");
          return BadRequest(ex.Message);
      }
  }
  

• 用curl访问该接口，查看返回结果与日志，定位错误节点。

6. 检查SQL Server远程连接配置 #

• 确认SQL Server配置管理器中TCP/IP协议已启用，监听端口（默认1433）开放。
• 检查服务器防火墙是否允许外部访问SQL Server端口。

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