如何在Entity Framework与MySQL中存储实体的Guid列表属性？

针对MySQL不支持原生数组类型的问题，以下是几种可行的解决方案，按推荐优先级排序：

1. 建立多对多关联实体（最符合数据库设计规范） #

关系型数据库的标准做法是通过中间表维护多对多关系，这也是EF推荐的方案，扩展性和可维护性最优。

步骤示例： #

首先定义Worker实体（若之前未定义）：

public class Worker
{
    [Required] [Key] public Guid Id { get; set; }
    // 可添加Worker的其他属性，如姓名、岗位等
    public ICollection<ProjectWorker> ProjectWorkers { get; set; }
}

创建中间关联实体ProjectWorker，用于维护项目与工人的关联：

public class ProjectWorker
{
    public Guid ProjectId { get; set; }
    public Project Project { get; set; }
    
    public Guid WorkerId { get; set; }
    public Worker Worker { get; set; }
}

修改Project实体，替换原数组属性为关联集合：

public class Project
{
    [Required] [Key] public Guid Id { get; set; }
    // 其他原有字段
    public ICollection<ProjectWorker> ProjectWorkers { get; set; }
}

在模型配置中定义多对多关系：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<ProjectWorker>(pw =>
    {
        // 设置联合主键
        pw.HasKey(x => new { x.ProjectId, x.WorkerId });
        
        // 配置与Project的关联
        pw.HasOne(x => x.Project)
          .WithMany(p => p.ProjectWorkers)
          .HasForeignKey(x => x.ProjectId);
          
        // 配置与Worker的关联
        pw.HasOne(x => x.Worker)
          .WithMany(w => w.ProjectWorkers)
          .HasForeignKey(x => x.WorkerId);
    });
}

这种方案支持直接在数据库中查询关联数据，便于后续扩展工人的属性，完全符合数据库范式。

2. 将数组序列化为字符串存储（适合简单场景） #

若无需在数据库层面操作工人ID列表，可将Guid序列化为JSON字符串或逗号分隔字符串，存储在MySQL的文本字段中。

代码示例： #

修改Project实体，添加序列化/反序列化逻辑：

using System.Text.Json;
using System.ComponentModel.DataAnnotations.Schema;

public class Project
{
    [Required] [Key] public Guid Id { get; set; }
    // 其他原有字段
    
    // 存储序列化后的字符串（映射到数据库字段）
    [AllowNull] public string WorkersJson { get; set; }
    
    // 业务逻辑用的非映射属性
    [NotMapped]
    public List<Guid> Workers
    {
        get => string.IsNullOrEmpty(WorkersJson) 
            ? new List<Guid>() 
            : JsonSerializer.Deserialize<List<Guid>>(WorkersJson);
        set => WorkersJson = JsonSerializer.Serialize(value);
    }
}

模型配置中指定存储字段类型：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Project>(x =>
    {
        x.HasKey(y => y.Id);
        // 根据数据量选择合适的字段类型，如TEXT或VARCHAR(MAX)
        x.Property(y => y.WorkersJson).HasColumnType("TEXT");
    });
}

此方案实现简单，但无法直接在数据库中过滤或查询工人ID，所有操作需在应用层完成。

3. 使用EF Core的ValueConverter自动转换 #

和方案2原理一致，但通过EF Core的ValueConverter自动处理序列化，无需额外的非映射属性。

代码示例： #

保持原Project实体结构不变：

public class Project
{
    [Required] [Key] public Guid Id { get; set; }
    // 其他原有字段
    [AllowNull] public List<Guid> Workers { get; set; }
}

在模型配置中添加转换器：

using System.Text.Json;

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Project>(x =>
    {
        x.HasKey(y => y.Id);
        
        x.Property(y => y.Workers)
          .HasConversion(
              // 序列化：List<Guid>转JSON字符串
              v => JsonSerializer.Serialize(v, (JsonSerializerOptions)null),
              // 反序列化：JSON字符串转List<Guid>
              v => JsonSerializer.Deserialize<List<Guid>>(v, (JsonSerializerOptions)null)
          )
          .HasColumnType("TEXT");
    });
}

此方案简化了实体代码，但同样存在无法在数据库端操作数组内容的局限。

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