VS2022部署Web API到Azure时EF Core迁移未识别连接字符串问题

使用Visual Studio 2022部署ASP.NET Core Web API项目到Azure App Service时，执行Entity Framework Core迁移步骤可正常识别MyPortfolioContext数据库上下文，但始终无法检测到关联的连接字符串，迁移流程无法推进。项目在本地环境运行无异常，仅在Azure发布流程中触发该问题。

相关参考截图 #

• 发布流程迁移操作界面：
• 项目appsettings.json配置文件：

现有数据库上下文代码 #

namespace MyPortfolioWebAPI.Data
{
    public class MyPortfolioContext:DbContext
    {
        public MyPortfolioContext(DbContextOptions<MyPortfolioContext> options) : base(options)
        {
        }

        public DbSet<Emails> Emails { get; set; } = null!;
        public DbSet<Projects> Projects { get; set; } = null!;
    }
}

该问题核心原因是VS发布流程的配置读取逻辑和本地运行环境不一致：本地运行会叠加读取开发环境配置、用户机密等多层配置，但发布流程默认仅读取正式环境appsettings.json和发布配置文件中显式声明的配置，按以下步骤排查修复：

• 第一步：校验基础配置一致性
  打开项目根目录的appsettings.json（注意不是appsettings.Development.json），确认连接字符串存放在根节点的ConnectionStrings字段下，键名和Program.cs中注册DbContext时传入的名称完全匹配，大小写敏感。正确配置结构示例：

  {
    "Logging": {
      "LogLevel": {
        "Default": "Information",
        "Microsoft.AspNetCore": "Warning"
      }
    },
    "AllowedHosts": "*",
    "ConnectionStrings": {
      "DefaultConnection": "Server=tcp:你的Azure SQL地址;Initial Catalog=你的库名;Persist Security Info=False;User ID=你的账号;Password=你的密码;MultipleActiveResultSets=False;Encrypt=True;TrustServerCertificate=False;Connection Timeout=30;"
    }
  }
  

  对应Program.cs中的DbContext注册代码不要夹带本地开发的硬编码逻辑，标准写法如下：

  var builder = WebApplication.CreateBuilder(args);
  // 其他服务注册代码
  builder.Services.AddDbContext<MyPortfolioContext>(options =>
      options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
  

• 第二步：直接在发布配置中显式指定迁移用连接字符串
  不要依赖发布流程自动从本地配置文件读取连接字符串，手动在发布配置中绑定：
  1. 右键项目选择「发布」，打开已创建的Azure App Service发布配置
  2. 找到「服务依赖」板块，选中已关联的SQL Server数据库项，点击编辑
  3. 在连接字符串输入框中填入目标Azure SQL数据库的完整连接字符串，同时勾选「迁移操作使用此连接字符串」「运行时使用此连接字符串」两个选项后保存
• 第三步：清除发布配置缓存
  如果上述配置完成后仍识别不到连接字符串，关闭VS，进入项目本地的Properties/PublishProfiles文件夹，删除对应Azure发布配置的.pubxml文件，重新打开VS创建新的发布流程，重新关联数据库和连接字符串即可。
• 备用验证方案
  可以先跳过发布界面的迁移校验步骤，先把项目部署到Azure App Service，部署完成后通过Azure门户的App Service控制台、或者VS的云资源连接功能进入项目运行目录，手动执行dotnet ef database update命令应用迁移，只要命令能执行成功，就说明连接字符串本身配置正确，问题仅出在VS发布界面的配置读取环节。

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