Entity Framework插入时向空字符串字段写入随机GUID问题排查

为第三方数据库搭建EF连接实现基础CRUD，此前运行正常。但插入applmort表记录时出现异常：该表的UWT字段为varchar(12)类型，非空且允许存入空字符串，我在EF配置中设置其默认值为string.Empty。但插入时未指定该字段值时，EF会将其作为备用键写入随机GUID，引发字符串截断错误。排查后发现是ApplicationHold与Application通过UWT建立的一对多关联导致，移除关联或提前设置UWT为空字符串可解决问题，但想确认是否存在配置错误。

实体类代码 #

public class Application
{
    public DateTime? ChangeDate { get; set; }
    public int ID { get; set; }
    public DateTime? ApplicationDate { get; set; }
    public string StructureID { get; set; } = null!;
    public string UWT { get; set; } = null!;
    public int UnitNumber { get; set; }
    
    public virtual Structure Structure { get; set; } = null!;
    public virtual ICollection<ApplicationHold> ApplicationHolds { get; set; } = [];
}

public class ApplicationHold
{
    public DateTime? ChangeDate { get; set; }
    public string UWT { get; set; } = null!;
    public int ID { get; set; }

    public virtual Application Application { get; set; } = null!;
}

EF配置类代码 #

public class ApplicationConfig : IEntityTypeConfiguration<Application>
{
    public void Configure(EntityTypeBuilder<Application> entity)
    {
        entity.ToTable("applmort");

        entity.HasKey(e => e.ID);

        entity.Property(e => e.ChangeDate)
            .HasColumnName("changedate")
            .HasColumnType("datetime")
            .HasDefaultValue(DateTime.Now)
            .IsRequired();
        entity.Property(e => e.ID)
            .HasColumnName("id")
            .UseIdentityColumn();
        entity.Property(e => e.ApplicationDate)
            .HasColumnName("appldate")
            .HasColumnType("datetime")
            .HasDefaultValue(DateTime.Now);
        entity.Property(e => e.StructureID)
            .HasColumnName("stru")
            .HasMaxLength(3)
            .HasDefaultValue(string.Empty)
            .IsRequired();
        entity.Property(e => e.UWT)
            .HasColumnName("uwt")
            .HasColumnType("varchar")
            .HasMaxLength(12)
            .HasDefaultValue(string.Empty)
            .IsRequired();
        entity.Property(e => e.UnitNumber)
            .HasColumnName("units")
            .HasColumnType("int")
            .HasDefaultValue(0)
            .IsRequired();

        entity.HasOne(e => e.Structure).WithMany(e => e.Applications)
            .HasForeignKey(e => e.LoanStructureID)
            .HasPrincipalKey(e => e.LoanStructureID)
            .IsRequired(false)
            .OnDelete(DeleteBehavior.NoAction);
    }
}

public class ApplicationHoldConfig : IEntityTypeConfiguration<ApplicationHold>
{
    public void Configure(EntityTypeBuilder<ApplicationHold> entity)
    {
        entity.ToTable("applhold");

        entity.HasKey(e => e.ID);

        entity.Property(e => e.ChangeDate)
            .HasColumnName("changedate")
            .HasColumnType("datetime")
            .HasDefaultValue(DateTime.Now)
            .IsRequired();
        entity.Property(e => e.ID)
            .HasColumnName("id")
            .UseIdentityColumn();
        entity.Property(e => e.UWT)
            .HasColumnName("uwt")
            .HasColumnType("varchar")
            .HasMaxLength(12)
            .HasDefaultValue(string.Empty)
            .IsRequired();

        entity.HasOne(entity => entity.Application).WithMany(e => e.ApplicationHolds)
            .HasForeignKey(entity => entity.UWT)
            .HasPrincipalKey(e => e.UWT)
            .IsRequired(false)
            .OnDelete(DeleteBehavior.NoAction);
    }
}

核心原因 #

EF处理备用键（Principal Key）关联时，默认会认为该字段需要生成唯一标识维护关联逻辑，即便配置了默认值。当UWT作为跨表关联键时，EF自动生成随机GUID填充该字段，超出varchar(12)长度限制引发截断错误。

配置修正建议 #

1. 禁用备用键自动生成
   在Application和ApplicationHold的UWT属性配置中添加.ValueGeneratedNever()，明确告知EF该字段无需自动生成值，使用配置的默认值即可：

   // ApplicationConfig中修改UWT配置
   entity.Property(e => e.UWT)
       .HasColumnName("uwt")
       .HasColumnType("varchar")
       .HasMaxLength(12)
       .HasDefaultValue(string.Empty)
       .IsRequired()
       .ValueGeneratedNever();
   
   // ApplicationHoldConfig中修改UWT配置
   entity.Property(e => e.UWT)
       .HasColumnName("uwt")
       .HasColumnType("varchar")
       .HasMaxLength(12)
       .HasDefaultValue(string.Empty)
       .IsRequired()
       .ValueGeneratedNever();
   

2. 优化实体初始化值
   将实体类中UWT的初始化值从null!改为string.Empty，避免EF追踪实体时判定字段未赋值：

   public string UWT { get; set; } = string.Empty;
   

3. 评估关联合理性
   如果UWT并非业务上的唯一标识字段，建议改用主键ID建立Application与ApplicationHold的一对多关联，避免非唯一字段作为关联键导致的逻辑混乱。

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