部署至Azure的ASP.NET Web API无法连接Azure SQL Server求助

一、Program.cs代码的潜在问题 #

你的代码存在两处关键问题，可能导致部署后连接失败：

1. 非开发环境连接串获取方式错误：Azure Web App中配置的「连接字符串」会被自动注入到ASP.NET的Configuration.ConnectionStrings集合中，而非直接作为环境变量存在。直接调用Environment.GetEnvironmentVariable无法正确读取Web App连接字符串配置（除非你是在「应用设置」而非「连接字符串」里配置的变量）。
2. 未处理空连接串的情况：如果连接串获取失败（比如配置名拼写错误），AddDbContext会因空值抛出异常，直接导致应用启动失败触发500错误。

修正后的代码示例 #

// 统一通过Configuration获取连接串，无需区分环境（ASP.NET会自动加载对应环境的配置）
var connection = builder.Configuration.GetConnectionString("AZURE_SQL_CONNECTIONSTRING");

// 增加空值校验，避免启动失败
if (string.IsNullOrEmpty(connection))
{
    throw new InvalidOperationException("未配置AZURE_SQL_CONNECTIONSTRING连接字符串");
}

builder.Services.AddDbContext<MyDbContext>(options => options.UseSqlServer(connection));

var app = builder.Build();

补充：开发环境无需手动重复添加AddEnvironmentVariables，ASP.NET默认会加载环境变量，且配置文件优先级低于环境变量（符合常规开发习惯）。

二、额外排查方向 #

除了你已做的操作，还可以从以下几个维度排查：

• 检查Web App连接串配置类型：在Azure门户的Web App「配置」->「连接字符串」中，确保你的连接串类型选择的是「SQL Server」，而非「Custom」。如果选了「Custom」，需要用builder.Configuration["AZURE_SQL_CONNECTIONSTRING"]来读取。
• 查看应用详细错误日志：在Web App的「监控」->「日志流」中实时查看启动日志，或开启「应用日志（文件系统）」下载日志文件，500错误的具体堆栈信息会明确指出失败原因（比如数据库登录失败、权限不足、依赖缺失等）。
• 添加Web App出站IP到SQL防火墙：Azure Web App的出站请求会使用固定的IP段，你可以在Web App「网络」->「出站IP地址」中获取所有IP，将这些IP添加到SQL Server的防火墙规则中（仅当你未开启「允许Azure服务和资源访问此服务器」时需要，但开启后仍可能存在个别IP未覆盖的情况）。
• 验证连接串加密配置：Azure SQL要求强制加密连接，确保连接串中包含Encrypt=True参数（Azure门户生成的连接串默认已包含），避免因未加密导致的连接拒绝。
• 检查托管身份权限（若使用）：如果用托管身份替代用户名密码连接SQL，需要确保Web App的托管身份已被添加到SQL Server的数据库角色中（比如db_owner或所需的读写权限），且连接串中使用Authentication=Active Directory Managed Identity参数。
• 确认.NET运行时版本匹配：在Web App「配置」->「常规设置」中，确保.NET运行时版本与本地开发环境一致（比如本地用.NET 6，Azure也需选择.NET 6），版本不兼容会导致启动失败。
• 测试连接有效性：使用Azure门户的「服务连接器」直接测试Web App到SQL Server的连接，确认连接本身无问题，排除配置以外的网络或权限故障。

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