部署至Azure的Minimal ASP.NET Core Web API /Members端点返回500错误

核心问题 #

本地运行时/weatherforecast和/Members端点均正常，部署到Azure Web App后/Members返回HTTP 500错误，核心原因集中在Azure环境的配置缺失或权限不足，以下是针对性排查和修复步骤：

1. 确认Azure Web App的连接字符串配置 #

本地在launchSettings.json和appsettings.json中配置的连接字符串不会自动同步到Azure Web App，需手动添加：

• 登录Azure Portal，找到目标Web App
• 进入配置 > 连接字符串
• 添加名称为AZURE_SQL_CONNECTIONSTRING的连接字符串，值填入你使用的Server=tcp:xxx;Database=xxx;Authentication=Active Directory Default;
• 注意：连接字符串类型选择SQLAzure（不选的话，Environment.GetEnvironmentVariable可能无法正确读取）

2. 配置Web App系统身份并赋予SQL访问权限 #

你使用Active Directory Default认证，本地依赖VS账号权限，但Azure Web App运行时默认使用自身系统身份，需为该身份赋予SQL访问权限：

• 在Web App页面进入身份 > 系统分配，启用系统身份（状态设为“开启”）
• 进入Azure SQL数据库页面，选择访问控制(IAM)，添加角色分配：
  • 角色选择SQL DB Contributor或Reader（按需选择）
  • 成员类型选择托管标识，选中你的Web App名称
• 等待权限生效（通常1-5分钟）

3. 添加异常捕获，暴露具体错误信息 #

当前代码未处理任何异常，导致500错误无法定位具体原因，修改/Members端点代码：

app.MapGet("/Members", () => {
    try
    {
        var rows = new List<string>();
        string connectionString = Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING");
        
        // 先校验连接字符串是否存在
        if(string.IsNullOrEmpty(connectionString))
        {
            return Results.BadRequest("连接字符串未配置");
        }

        using var conn = new SqlConnection(connectionString);
        conn.Open();

        var command = new SqlCommand("SELECT * FROM WHATEVER", conn);
        using SqlDataReader reader = command.ExecuteReader();

        if (reader.HasRows)
        { 
            while (reader.Read())
            {
                rows.Add($"{reader.GetInt32(0)}, {reader.GetString(1)}, {reader.GetString(2)}, {reader.GetString(3)}, {reader.GetString(4)}, {reader.GetInt32(5)}, {reader.GetInt32(6)}, {reader.GetDecimal(7)}, {reader.GetInt32(8)}, {reader.GetDateTime(9)}");
            }
        }

        return Results.Ok(rows);
    }
    catch(Exception ex)
    {
        // 排查完成后可改为通用提示
        return Results.Problem(ex.Message);
    }
})
.WithName("GetMembers")
.WithOpenApi();

重新部署后，调用/Members会返回具体错误（如连接字符串为空、权限不足、表不存在等），快速定位问题。

4. 检查Azure SQL防火墙规则 #

确保Azure SQL允许Web App访问：

• 进入Azure SQL数据库页面，选择防火墙和虚拟网络
• 勾选“允许Azure服务和资源访问此服务器”（开启）
• 或者手动添加Web App的出站IP（在Web App属性页面可查看出站IP列表）

5. 验证数据库表结构 #

确认Azure SQL中存在WHATEVER表，且字段顺序、类型与代码中reader.GetInt32(0)等调用完全匹配，避免因字段索引或类型不匹配导致读取失败。

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