本地正常的连接字符串在Azure中初始化失败的技术求助

核心问题排查步骤 #

1. 确认连接字符串的配置位置 #

• 必须在App Service的配置>应用程序设置的连接字符串区域添加，而非普通的"应用程序设置"项。EF Core默认从ConnectionStrings配置节点读取，若放在普通设置里，需手动指定读取路径。
• 配置时选择连接字符串类型为PostgreSQL或自定义，名称要和代码中读取的名称一致（比如DefaultConnection）。

2. 验证代码中连接字符串的读取逻辑 #

确保Program.cs中正确读取连接字符串，示例代码：

var builder = WebApplication.CreateBuilder(args);

// 正确读取ConnectionStrings节点下的配置
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");

builder.Services.AddDbContext<YourDbContext>(options =>
    options.UseNpgsql(connectionString));

• 避免直接读取普通配置项（如builder.Configuration["DefaultConnection"]），除非你特意把连接字符串放在根节点。

3. 处理密码中的特殊字符 #

如果密码包含@、$、&等特殊字符，需要对特殊字符进行URL编码后再填入连接字符串：

• 例如：@替换为%40，$替换为%24，&替换为%26。

4. 修正SSL Mode配置 #

Azure PostgreSQL推荐使用Ssl Mode=Require或Ssl Mode=VerifyCA，而非VerifyFull：

• VerifyFull需要严格匹配服务器证书的完全域名，App Service环境下可能无法通过验证；
• 确保连接字符串中参数是Ssl Mode（注意空格），Npgsql不识别无空格的SslMode。

5. 调整EF迁移执行方式 #

部署时自动执行迁移可能因权限或连接问题报错，建议：

• 本地生成迁移脚本：dotnet ef migrations script -o migration.sql；
• 将生成的SQL脚本直接在Azure PostgreSQL的查询编辑器中执行，避免部署时的迁移执行问题。
• 若坚持自动执行，确保代码只在正确环境下触发：

var app = builder.Build();

using (var scope = app.Services.CreateScope())
{
    var dbContext = scope.ServiceProvider.GetRequiredService<YourDbContext>();
    if (app.Environment.IsProduction())
    {
        dbContext.Database.Migrate();
    }
}

6. 确认防火墙规则配置 #

• 进入App Service概述>属性，复制所有出站IP地址，添加到Azure PostgreSQL的防火墙规则中；
• 同时开启Azure PostgreSQL的允许Azure服务和资源访问此服务器选项，避免遗漏动态IP。

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