EF Core 6 Code First迁移MariaDb报错：near 'max)'语法错误

问题诊断 #

核心问题在于EF Core生成了SQL Server专属的nvarchar(max)语法，而MariaDb不支持该类型。驱动本该自动将模型类型映射为数据库适配的语法，但你的场景中未生效；Role表正常创建，大概率是其字段配置逻辑和User实体存在差异（比如字段都明确指定了长度，或未触发类型映射冲突）。

原因分析及解决步骤 #

1. 移除多驱动冲突 #

不要同时使用Pomelo.EntityFrameworkCore.MySql和Devart.Data.MySql.EFCore两个驱动，这会导致EF Core无法确定使用哪个提供程序做类型映射，是引发错误的常见诱因。

• 解决：保留其中一个驱动（推荐Pomelo，对MariaDb兼容性更好），移除另一个的NuGet引用及相关配置。

2. 确保字符串字段配置生效 #

虽然你给User实体的Password、DisplayName加了[MaxLength(50)]，但可能存在以下情况：

• User实体中有其他未标注长度的字符串字段，EF Core默认映射为nvarchar(max)，驱动未正确转换为MariaDb支持的text/longtext；
• [MaxLength]被Fluent API配置覆盖，导致Data Annotation未生效。
• 解决：
  • 检查User实体所有字符串字段，统一通过Data Annotation或Fluent API明确配置：

    // Data Annotation示例
    [MaxLength(50)]
    public string Password { get; set; }
    
    // Fluent API示例（在DbContext的OnModelCreating中）
    modelBuilder.Entity<User>()
        .Property(u => u.DisplayName)
        .HasMaxLength(50)
        .IsUnicode(false); // 无需多字节字符时关闭Unicode，对应MariaDb的varchar类型
    

  • 确认IsUnicode()设置符合需求：MariaDb的nvarchar是UTF-8编码，不需要的话用varchar更高效，驱动会自动转换对应类型。

3. 清理残留迁移文件 #

如果迁移文件是在SQL Server环境下生成的，会硬编码nvarchar(max)等SQL Server专属语法，直接迁移到MariaDb会报错。

• 解决：
  1. 删除项目中Migrations文件夹下的所有迁移文件；
  2. 删除MariaDb中已创建的__EFMigrationsHistory表和已生成的表；
  3. 重新生成针对MariaDb的迁移：

     Add-Migration InitialCreate -Context YourDbContextName
     

  4. 执行迁移（或代码中调用context.Database.Migrate()）：

     Update-Database -Context YourDbContextName
     

4. 修正DbContext配置 #

确保DbContext正确指定MariaDb提供程序及版本，避免混合SQL Server配置：

protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseMySql(
        "server=localhost;database=your_db;user=root;password=your_pwd;",
        new MySqlServerVersion(new Version(10, 6, 5)) // 替换为你的MariaDb实际版本
    );
}

注意：必须指定MySqlServerVersion，否则驱动无法正确识别数据库类型，导致类型映射错误。

对疑问的解答 #

• 驱动为何未自动转换语法？：当存在多驱动冲突、DbContext配置错误、迁移文件残留SQL Server配置时，EF Core无法触发驱动的类型映射逻辑，导致生成SQL Server专属语法；此外，若实体字段未明确指定长度，部分驱动默认情况下可能未正确处理nvarchar(max)到MariaDb类型的转换。
• Role表为何创建无错误？：Role实体的字符串字段可能都明确指定了长度，EF Core默认映射的类型（如varchar(255)）是MariaDb支持的；也可能Role实体的迁移逻辑未受到驱动冲突或残留配置的影响。

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