.NET 6 Blazor应用部署Azure App Service后无法连接SQL Server VM

1. 捕获完整的SQL异常细节 #

默认的SqlException提示过于笼统，需获取完整错误信息定位根源：

• 在Azure门户进入目标App Service，开启日志流（左侧菜单>监控>日志流），触发数据库访问操作，查看完整的异常堆栈与错误代码（如18456表示登录失败，10060表示连接超时）。
• 在Blazor应用中添加全局异常捕获：在Program.cs中配置日志记录完整异常信息，或在Blazor错误边界组件中记录Exception.ToString()，避免仅显示简化错误。

2. 验证.NET 6 SQL客户端的行为差异 #

.NET 6使用Microsoft.Data.SqlClient（取代.NET Core 3.1的System.Data.SqlClient），默认行为存在差异：

• 加密设置差异：.NET 6中Encrypt默认值为True，若SQL Server VM未配置可信SSL证书，会导致连接失败。可临时在连接字符串中添加Encrypt=False或TrustServerCertificate=True测试（注意生产环境需配置合法证书）。
• 连接字符串参数兼容性：检查是否存在.NET 6不支持的旧参数，例如部分过时的连接选项，可对比其他.NET Core 3.1站点的连接字符串格式，剔除冗余参数后测试。

3. 确认App Service的.NET运行时配置 #

• 登录Azure门户，进入目标App Service>配置>常规设置，确认.NET运行时版本为.NET 6 (STS)，避免发布时误选成.NET Core 3.1。
• 若为Blazor Server应用，检查托管模型是否为进程内（默认），部分进程外托管场景可能存在网络访问差异。

4. 细粒度验证数据库权限 #

即使使用同一凭据，需确认用户对目标数据库的具体权限：

• 在SQL Server VM上执行以下查询，检查用户对涉事数据库的权限：

  USE [你的目标数据库名];
  SELECT dp.permission_name, dp.state_desc
  FROM sys.database_permissions dp
  JOIN sys.database_principals dpri ON dp.grantee_principal_id = dpri.principal_id
  WHERE dpri.name = '你的数据库用户名';
  

• 确认用户拥有db_datareader、db_datawriter等必要权限，未被设置DENY规则。

5. 验证连接字符串的加载正确性 #

• 检查Azure门户中App Service>配置>连接字符串是否正确设置目标数据库的Initial Catalog，避免代码中硬编码的连接字符串与Azure配置冲突（优先使用Azure门户配置的连接字符串）。
• 在应用中添加临时日志输出连接字符串的关键部分（如Initial Catalog），确认加载的是正确的数据库名称。

6. 深层网络连通性测试 #

• 使用App Service的Kudu控制台（https://<你的应用名>.scm.azurewebsites.net/）执行网络测试：
  • Windows环境：Test-NetConnection <SQL VM IP> -Port 1433
  • Linux环境：telnet <SQL VM IP> 1433 或 nc -zv <SQL VM IP> 1433
    确认端口连通性，排除偶发的网络路由问题。

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