.NET Core 2.1应用在IIS Express运行无法连接LocalDB如何解决

根因判断 #

该问题确实和IIS的配置直接相关：错误日志中明确提到核心问题，如下：

System.Data.SqlClient.SqlException (0x80131904): ..... 很可能未加载用户配置文件。如果在IIS下执行LocalDB，请确保为当前用户启用了配置文件加载。

LocalDB是用户级别的数据库实例，依赖当前登录用户的配置文件读取运行时存储路径，IIS Express默认未开启用户配置文件加载，就会触发该错误。你之前修改连接字符串加端口、指定mdf路径的操作不解决核心问题，因此无效。

解决步骤 #

方案1：修改IIS Express应用池配置（优先选择） #

• 开启资源管理器的「显示隐藏文件」选项，打开项目根目录下的.vs\{你的项目名称}\config\applicationhost.config文件
• 定位到<system.applicationHost> -> <applicationPools>节点，找到名称和你项目名一致的应用池配置
• 在该应用池的<processModel>节点中添加/修改两个属性：loadUserProfile="true"、setProfileEnvironment="true"，修改后的配置示例：

<processModel identityType="ApplicationPoolIdentity" loadUserProfile="true" setProfileEnvironment="true" />

• 完全退出当前运行的IIS Express，重启Visual Studio后再启动项目即可。

方案2：修改项目调试属性（简化操作） #

如果找不到.vs下的配置文件，可以直接在VS中修改项目属性：

• 右键WebAPI项目 → 选择「属性」→ 切换到「调试」标签
• 下拉找到「Web服务器设置」模块，取消勾选「启用编辑并继续」
• 保存设置后重新运行项目即可，该操作会自动触发IIS Express加载用户配置文件。

方案3：共享LocalDB实例（适合正式IIS部署场景） #

如果后续需要部署到正式IIS环境使用LocalDB，可以将实例设置为共享，规避用户配置文件问题：

• 打开管理员权限的命令提示符，执行命令：
  sqllocaldb share MSSQLLocalDB SharedLocalDB
• 修改连接字符串的数据源部分为(localdb)\.\SharedLocalDB即可。

连接字符串修正建议 #

• 移除连接字符串中(localdb)\\MSSQLLocalDB后的,1433配置，LocalDB默认使用命名管道连接，不需要指定TCP端口，多余配置会导致连接失败
• 不需要显式指定AttachDbFilename参数，你已经将数据库附加到MSSQLLocalDB实例，直接使用从SQL Server对象资源管理器复制的、带Initial Catalog=TokenAuth的连接字符串即可。

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