部署于IIS的ASP.NET Core 3.1应用无法连接指定本地数据库

问题概况 #

• 部署到IIS的ASP.NET Core 3.1应用未连接指定本地数据库，疑似使用了其他数据源
• Windows事件日志显示应用启动正常：Application 'C:\inetpub\wwwroot\retailbanking\' started successfully.
• 本地开发环境的Retail Banking数据库dbo.aspnetusers表已有大量注册用户，但IIS访问时登录提示用户未注册；新注册用户的数据也未写入该库，无法找到数据存储位置
• 本地运行时appsettings.json配置完全正常，仅IIS部署后出现该异常

当前配置 #

appsettings.json #

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    }
  },
  "AllowedHosts": "*",
  "ConnectionStrings": {
    "Default Connection": "Server=(localdb)\\MSSQLLocalDB;Database=Retail Banking;Trusted_Connection=True;MultipleActiveResultSets=true"
  }
}

applicationHost.config（应用池默认配置） #

<applicationPoolDefaults managedRuntimeVersion="v4.0">
    <processModel identityType="ApplicationPoolIdentity" loadUserProfile="true" setProfileEnvironment="true" />
</applicationPoolDefaults>

已尝试操作 #

• 切换应用池身份为Local System和ApplicationPoolIdentity，问题未得到解决

排查与解决步骤 #

1. 定位LocalDB实例差异问题 #

LocalDB是用户级数据库实例，每个Windows用户都会拥有独立的LocalDB实例环境。你本地开发时创建的Retail Banking数据库，仅存在于开发用户的LocalDB实例中；而IIS应用池（无论是ApplicationPoolIdentity还是Local System）作为独立的用户上下文，会启动自己的LocalDB实例，自然看不到你本地开发的数据库数据，新注册的用户数据也会存在这个独立实例里。

验证方法：

• 以应用池身份启动命令行：如果用ApplicationPoolIdentity，可使用PsExec.exe -i -s cmd.exe打开系统权限命令行，执行sqllocaldb info查看当前实例，再执行sqllocaldb start MSSQLLocalDB和sqlcmd -S (localdb)\MSSQLLocalDB查看该实例下的数据库列表，就能发现和你本地开发实例的差异。

2. 替换LocalDB为完整SQL Server实例 #

LocalDB仅适合开发环境，生产/部署环境建议改用完整的SQL Server实例（如SQL Server Express），修改连接字符串：

Server=.\SQLEXPRESS;Database=Retail Banking;Trusted_Connection=True;MultipleActiveResultSets=true

然后给应用池身份（格式为IIS APPPOOL\你的应用池名称）赋予该数据库的db_datareader和db_datawriter权限，确保能正常读写。

3. 若坚持使用LocalDB，需共享实例 #

如果必须使用LocalDB，需将开发环境的LocalDB实例共享给IIS应用池身份：

1. 用本地开发用户打开命令行，执行：

   sqllocaldb share MSSQLLocalDB RetailBankingShared
   

2. 修改连接字符串指向共享实例：

   Server=(localdb)\.\RetailBankingShared;Database=Retail Banking;Trusted_Connection=True;MultipleActiveResultSets=true
   

3. 给应用池身份赋予该共享实例的访问权限，可通过SQL Server Management Studio添加对应登录名并映射数据库权限。

4. 验证应用实际加载的连接字符串 #

有时IIS环境下的环境变量、配置覆盖会导致应用未加载预期的appsettings.json配置，可在应用中添加日志输出当前使用的连接字符串：
在Program.cs（ASP.NET Core 3.1）中添加：

using Microsoft.Extensions.Logging;

public static IHostBuilder CreateHostBuilder(string[] args) =>
    Host.CreateDefaultBuilder(args)
        .ConfigureLogging((context, logging) =>
        {
            var connectionString = context.Configuration.GetConnectionString("Default Connection");
            logging.AddConsole();
            logging.LogInformation("当前加载的连接字符串: {ConnStr}", connectionString);
        })
        .ConfigureWebHostDefaults(webBuilder =>
        {
            webBuilder.UseStartup<Startup>();
        });

查看应用日志，确认连接字符串是否和配置文件一致。

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