从Azure Web App连接Azure SQL Database时出现500错误求助

1. 验证Azure SQL服务器防火墙规则 #

• 确保Azure SQL服务器的允许Azure服务和资源访问此服务器选项已开启（在Azure门户的SQL服务器→防火墙和虚拟网络设置中）
• 手动添加Web App的所有出站IP到SQL防火墙规则：
  1. 进入Azure Web App→网络→出站IP地址，复制全部IP
  2. 在SQL服务器防火墙规则中逐一添加这些IP范围

2. 确认连接字符串配置 #

• 检查Web App应用设置中的连接字符串与本地测试版本完全一致，优先使用Web App的连接字符串配置项而非硬编码的AppSettings
• 验证连接字符串参数：Server地址、Database名称、User ID、Password（或Azure AD认证参数）均正确
• 确保项目引用Microsoft.Data.SqlClient（.Net 8推荐）而非旧版System.Data.SqlClient，并更新到最新稳定版

3. 检查Web App网络配置 #

• 若Web App部署在虚拟网络中，确认虚拟网络与SQL服务器的对等连接已建立且生效
• 若启用了SQL专用终结点，检查专用终结点的DNS解析是否正常，确保Web App能正确解析SQL服务器地址

4. 验证SQL DB状态与权限 #

• 确认Azure SQL DB实例处于联机状态（Azure门户→SQL数据库→概览）
• 检查SQL用户权限：在SQL Server中执行以下语句，确认用户具备登录和数据库访问权限

  SELECT name, type_desc FROM sys.server_principals WHERE name = '你的SQL用户名';
  SELECT name, permission_name FROM sys.database_permissions WHERE grantee_principal_id = (SELECT principal_id FROM sys.database_principals WHERE name = '你的SQL用户名');
  

5. 优化连接池与传输设置 #

• 在连接字符串中添加以下参数，优化连接稳定性：

  Connect Timeout=30;Max Pool Size=100;Min Pool Size=5;Pooling=true;Encrypt=true;TrustServerCertificate=false
  

  • Encrypt=true和TrustServerCertificate=false满足Azure SQL强制加密要求
  • 调整连接池参数避免连接耗尽
• 在Azure门户→Web App→日志流中查看实时日志，排查是否存在连接超时或池耗尽提示

6. 直接测试连接可用性 #

• 使用Azure门户的SQL查询编辑器连接数据库，验证数据库本身可正常访问
• 在Web App的Kudu控制台中执行sqlcmd命令测试连接：

  sqlcmd -S 你的SQL服务器名.database.windows.net -d 数据库名 -U 用户名 -P 密码
  

  命令失败则指向网络/认证问题，成功则需排查应用代码逻辑

7. 检查应用连接管理逻辑 #

• 确保代码中使用using语句自动释放数据库连接，避免泄漏：

  using (var connection = new SqlConnection(connectionString))
  {
      connection.Open();
      // 执行数据库操作
  }
  

• 排查自定义ConnectionManager的连接复用逻辑，确认连接被正确关闭和回收

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