.NET7中SqlTableDependency调试正常，发布到IIS触发SQL连接异常

问题描述 #

SqlTableDependency在IIS Express调试环境中可成功启动，但发布至IIS后出现错误，核心错误信息为：

The type initializer for 'System.Data.SqlClient.TdsParser' threw an exception.

已在Windows Server上安装SQL Server Native Client，但问题仍未解决。

相关代码 #

private SqlTableDependency<WfeVendorChats> _tableDependency;

private void StartSqlTableDependency()
{
    var connectionString = _configuration.GetConnectionString("ConnectionApp");
    Log.Information("StartSqlTableDependency. connection = " + connectionString);
    var tableName = "wfe_vendor_chats"; // Set the table name

    try
    {
        Log.Information("_tableDependency connectionString " + connectionString);
        Log.Information("_tableDependency tableName " + tableName);
        _tableDependency = new SqlTableDependency<WfeVendorChats>(connectionString, tableName);
        _tableDependency.OnChanged += (sender, e) => Dependency_OnChanged(sender, e);
        _tableDependency.Start();
        Log.Information("_tableDependency start");
    }
    catch (Exception ex)
    {
        Log.Error("_tableDependency error. Reason: " + ex.Message);
        Log.Error("Exception Type: " + ex.GetType().FullName);
        Log.Error("Stack Trace: " + ex.StackTrace);
    }
}

错误日志 #

{"Timestamp":"2023-08-07T00:12:38.5445741+07:00","Level":"Error","MessageTemplate":"_tableDependency error. Reason: The type initializer for 'System.Data.SqlClient.TdsParser' threw an exception.","Properties":{"TransportConnectionId":"iDxQPLk4t9T8j8sa0PWFcg","RequestId":"800032df-0000-d000-b63f-84710c7967bb","RequestPath":"/chatHub"}}

解决建议 #

• 检查IIS应用程序池身份权限：IIS默认应用池身份（如ApplicationPoolIdentity、Network Service）可能无SQL Server访问权限。可将应用池身份改为拥有数据库权限的域账号/本地账号，或给当前身份赋予数据库的连接、操作权限。
• 验证连接字符串配置：确认发布后appsettings.json或web.config中的连接字符串正确，包括服务器地址、认证方式（Windows/SQL认证）。若用Windows认证，需确保应用池身份有权限；若用SQL认证，检查用户名密码正确性及SQL Server是否允许该账号远程连接。
• 核对.NET运行时版本兼容性：SqlTableDependency对.NET版本有要求，确保服务器安装的.NET Runtime/SDK与开发环境一致。若使用.NET Core/.NET 5+，需确认IIS已配置对应托管模块。
• 排查SqlClient依赖问题：TdsParser初始化错误多与SqlClient依赖相关。尝试更新System.Data.SqlClient NuGet包至最新稳定版，或改用Microsoft.Data.SqlClient（官方推荐替代库），修改代码引用后重新发布。
• 检查SQL Server配置：
  • 确认SQL Server允许远程连接（若数据库不在本地），启用TCP/IP协议，防火墙开放1433端口；
  • 检查数据库Service Broker是否启用，SqlTableDependency依赖该功能监听表变化。执行以下SQL查询验证：

    SELECT name, is_broker_enabled FROM sys.databases WHERE name = '你的数据库名'
    

    若未启用，执行：

    ALTER DATABASE 你的数据库名 SET ENABLE_BROKER WITH ROLLBACK IMMEDIATE;
    

• 捕获完整异常信息：修改catch块，添加对InnerException的日志记录，获取更具体的错误根源，比如：

  catch (Exception ex)
  {
      Log.Error("_tableDependency error. Reason: " + ex.Message);
      if (ex.InnerException != null)
      {
          Log.Error("Inner Exception: " + ex.InnerException.Message);
          Log.Error("Inner Stack Trace: " + ex.InnerException.StackTrace);
      }
      Log.Error("Exception Type: " + ex.GetType().FullName);
      Log.Error("Stack Trace: " + ex.StackTrace);
  }
  

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