如何解决Azure App Service中ASP.NET项目无法连接Azure SQL数据库问题？

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

• 进入Azure门户的SQL服务器页面，打开「防火墙和虚拟网络」设置
• 确认已勾选「允许Azure服务和资源访问此服务器」；若使用固定IP访问，需将App Service的所有出站IP（可在App Service「属性」页查看）添加到防火墙允许列表
• 测试本地用相同连接字符串通过SSMS/Azure Data Studio连接SQL，排除网络层面的基础问题

2. 确认连接字符串的配置与读取逻辑 #

• 不要硬编码连接字符串，必须通过App Service「配置」->「连接字符串」模块配置，ASP.NET中用Configuration.GetConnectionString("YourConnKey")读取
• 核对连接字符串细节：服务器名称需完全匹配（格式为servername.database.windows.net）、数据库名称无误、SQL认证的用户名格式为servername\adminaccount、密码无特殊字符转义错误

3. 检查身份认证配置 #

• 若用SQL认证：确保SQL服务器的管理员账号未被禁用、密码未过期
• 若用Azure AD托管身份认证：
  • 确认App Service已启用系统分配/用户分配身份
  • 在SQL数据库中执行语句添加身份权限：

    CREATE USER [AppServiceIdentityName] FROM EXTERNAL PROVIDER;
    ALTER ROLE db_datareader ADD MEMBER [AppServiceIdentityName];
    ALTER ROLE db_datawriter ADD MEMBER [AppServiceIdentityName];
    

  • 连接字符串需包含Authentication=Active Directory Managed Identity参数

4. 查看App Service日志定位具体错误 #

• 开启App Service的「应用日志」和「详细错误日志」，在「日志流」中查看连接失败的具体报错：
  • 若出现Login failed for user：排查账号权限或认证方式
  • 若出现A network-related error：重点检查防火墙或网络路由
  • 若出现Timeout expired：检查SQL服务器负载（DTU/CPU使用率）或网络延迟

5. 核对ASP.NET数据库上下文配置 #

• 确保Program.cs/Startup.cs中DbContext正确绑定连接字符串：

  builder.Services.AddDbContext<YourDbContext>(options =>
      options.UseSqlServer(builder.Configuration.GetConnectionString("YourConnKey")));
  

• 排查代码中是否存在覆盖连接字符串的逻辑（如环境变量、调试配置）

6. 确认SQL数据库状态 #

• 检查Azure SQL数据库是否处于「联机」状态，无暂停、缩放或维护中的情况
• 查看SQL服务器的监控指标，确认CPU、内存、DTU使用率未达上限

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