使用Entity Framework生成迁移脚本时如何指定特定MariaDb版本？

可以通过指定EF Core MariaDb提供者的目标服务器版本来生成兼容10.3的迁移脚本，具体步骤如下：

1. 配置DbContext的目标ServerVersion #

EF Core的Pomelo MySQL/MariaDb提供者会根据指定的ServerVersion生成对应版本兼容的SQL语法，你需要在DbContext配置中明确指定生产环境的MariaDB 10.3版本：

方式1：在DbContext的OnConfiguring方法中设置 #

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseMySql(
        "你的数据库连接字符串",
        MariaDbServerVersion.Parse("10.3.0"), // 明确指定目标版本为10.3
        opts => opts.MigrationsAssembly("你的迁移项目名称")
    );
}

方式2：依赖注入配置（Program.cs/Startup.cs） #

builder.Services.AddDbContext<YourDbContext>(options =>
{
    var connString = builder.Configuration.GetConnectionString("YourConnString");
    // 指定目标MariaDB版本
    var targetVersion = MariaDbServerVersion.Parse("10.3.0");
    options.UseMySql(connString, targetVersion);
});

2. 生成适配10.3的迁移脚本 #

配置完成后，直接执行你原本的迁移脚本生成命令即可：

dotnet ef migrations script --output script-prod.sql

此时生成的script-prod.sql会使用MariaDB 10.3兼容的语法（比如列重命名会用ALTER TABLE ... CHANGE而非10.5+的RENAME COLUMN）。

3. 可选：动态切换版本适配开发/生产 #

如果需要在开发环境（10.6）和生产环境（10.3）之间快速切换，可以通过配置文件或环境变量动态指定版本：

1. 在appsettings.json中添加版本配置：

{
  "ConnectionStrings": { "YourConnString": "..." },
  "TargetMariaDbVersion": "10.6.12"
}

2. 修改DbContext配置读取该值：

builder.Services.AddDbContext<YourDbContext>(options =>
{
    var connString = builder.Configuration.GetConnectionString("YourConnString");
    // 优先读取环境变量，否则用配置文件中的值
    var targetVersionStr = Environment.GetEnvironmentVariable("TARGET_MARIADB_VERSION") 
                          ?? builder.Configuration["TargetMariaDbVersion"] 
                          ?? "10.6.12";
    var targetVersion = MariaDbServerVersion.Parse(targetVersionStr);
    options.UseMySql(connString, targetVersion);
});

3. 生成生产脚本时通过环境变量指定版本：

# Windows
set TARGET_MARIADB_VERSION=10.3.0 && dotnet ef migrations script --output script-prod.sql

# Linux/macOS
export TARGET_MARIADB_VERSION=10.3.0 && dotnet ef migrations script --output script-prod.sql

注意事项 #

• 确保你使用的Pomelo.EntityFrameworkCore.MySql版本支持指定ServerVersion（推荐3.2.0及以上版本）
• 检查迁移中是否使用了MariaDB 10.3不支持的特性（如某些新数据类型），若有需调整迁移代码

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