IIS部署ASP.NET应用Entity Framework数据库连接失败求助

问题 #

在新创建的Windows Server服务器上通过IIS部署迁移过来的ASP.NET应用时，遇到Entity Framework无法连接数据库的问题。

应用的连接字符串如下：

<connectionStrings>
    <add name="ApplicationServices" connectionString="Data Source=LOCALCOMPUTER\SQLEXPRESS;Initial Catalog=xxx;Persist Security Info=True;User ID=yyy;Password=zzz" providerName="System.Data.SqlClient"/>
    <add name="MembershipConnection" connectionString="metadata=res://*/App_Code.Membership.Membership.csdl|res://*/App_Code.Membership.Membership.ssdl|res://*/App_Code.Membership.Membership.msl;provider=System.Data.SqlClient;provider connection string=&quot;Data Source=LOCALCOMPUTER\SQLEXPRESS;Initial Catalog=xxx;Persist Security Info=True;User ID=yyy;Password=zzz;MultipleActiveResultSets=True;Application Name=EntityFramework&quot;" providerName="System.Data.EntityClient"/>
    ...
</connectionStrings>

其中LOCALCOMPUTER为本地计算机的FDQN，该计算机未加入域。登录模块使用ApplicationServices连接字符串可正常验证用户密码，但代码创建EF上下文时抛出异常：

The underlying provider failed on Open.:
A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify that the instance name is correct and that SQL Server is configured to allow remote connections. (provider: TCP Provider, error: 0 - The wait operation timed out.)

已完成排查项：

• 应用在其他环境运行正常
• SSMS可凭相同凭据连接数据库
• 配置了可访问数据库的应用池本地账户，且尝试过Integrated Security=SSPI
• 已安装.NET 3.5和4.8
• 数据库已映射用户并赋予dbowner等权限

排查方案 #

• 核对EF连接字符串的转义正确性：确认EF的provider connection string部分转义后的内容与ApplicationServices完全一致，包括数据源、账号密码等细节，避免转义过程中出现字符遗漏或错误。
• 替换本地实例标识：将LOCALCOMPUTER\SQLEXPRESS替换为.\SQLEXPRESS（本地实例简写）、127.0.0.1\SQLEXPRESS或localhost\SQLEXPRESS，排查FDQN解析异常导致的连接失败。
• 检查SQL Server TCP/IP协议状态：打开SQL Server配置管理器，确认SQLEXPRESS实例的TCP/IP协议已启用；通过netstat -ano | findstr "1433"命令验证默认端口（或动态端口）是否处于监听状态。
• 检查应用池身份模拟设置：在IIS管理器的应用池高级设置中，查看“身份模拟”状态。若启用，需确保模拟账户拥有数据库访问权限；若无需模拟，可设置为“禁用”后重试。
• 单独测试EF连接字符串：编写简单控制台应用，使用MembershipConnection连接字符串创建EF上下文并执行基础查询，验证连接是否有效，排除IIS环境特有配置干扰。
• 验证防火墙规则：确认Windows防火墙允许SQL Server实例端口（1433或动态端口）的入站/出站连接，即使本地连接，部分防火墙规则也可能限制Loopback接口通信。
• 查看SQL Server错误日志：在SSMS中打开“管理”->“SQL Server日志”，查找该连接相关的错误记录，获取更具体的失败原因（如登录拒绝、权限问题等）。
• 确认EF元数据路径有效性：检查EF连接字符串中的metadata路径，确保部署后元数据文件（.csdl/.ssdl/.msl）已正确嵌入程序集或存在于指定路径，避免元数据加载失败间接引发连接异常。

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