ASP.NET Core 8中EF Core自动设置UserId为超大负值引发转换错误

这个超大负值的来源 #

• -9223372036854774807 就是**Int64.MinValue**，也就是C#中long类型能存储的最小数值。
• EF Core会用这个值作为临时主键值：当你添加未手动赋值主键的实体时，EF Core需要一个唯一值在上下文中跟踪该实体（直到SaveChanges时从数据库获取真正的主键值），默认的数值类型主键生成器会用对应类型的最小值作为临时标识。

触发转换错误的原因 #

你给long类型的UserId配置了转int的转换器，但Int64.MinValue远超出int类型的取值范围（int范围是 -2147483648 到 2147483647），当SaveChanges时EF Core尝试将这个临时值转换为int存入数据库，就触发了溢出异常。

替代try-catch的合理解决方案 #

方案1：统一实体与数据库的主键类型（推荐） #

直接把实体的UserId类型改成int，和数据库类型保持一致，完全不需要转换器，从根源避免类型转换问题。

方案2：自定义临时值生成器（必须保留long类型时） #

如果因业务需求必须用long类型的UserId，可以自定义一个ValueGenerator，生成在int范围内的临时值，替换EF Core的默认生成器：

// 自定义生成器，生成int范围内的临时long值
public class IntRangeLongTempValueGenerator : ValueGenerator<long>
{
    private long _tempValue = -2147483648; // 从int最小值开始递减

    public override bool GeneratesTemporaryValues => true;

    public override long Next(EntityEntry entry)
    {
        return _tempValue--;
    }
}

在DbContext的模型配置中指定这个生成器：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<UserModel>()
        .Property(u => u.UserId)
        .HasConversion<int>() // 保留int转换器
        .HasValueGenerator<IntRangeLongTempValueGenerator>(); // 替换临时值生成器
}

方案3：手动赋值临时主键值 #

添加UserModel实体时，手动给UserId赋一个在int范围内的临时值（比如负数，避免和数据库自增正主键冲突），EF Core就不会自动生成Int64.MinValue：

var newUser = new UserModel
{
    UserId = -1, // 临时值，在int范围内
    // 其他属性赋值
};
context.Users.Add(newUser);
context.SaveChanges();

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