EF Core如何配置IdentityUser.PhoneNumber为数据库可空字段

问题根源 #

你遇到的配置不生效、迁移无变更问题，核心是两个机制导致的：

• base.OnModelCreating(builder)会加载Identity内置的一套实体配置规则，部分版本的Identity会通过EF Core底层元数据接口锁定字段约束，你用高层Fluent API写的IsRequired(false)不会覆盖这套锁定的配置，EF Core模型对比时会判定配置无变化，自然不会生成迁移。
• 如果你开启了C#可空引用类型，.NET 5及更早版本的Identity基类中PhoneNumber定义为非空string，首次生成迁移时会自动把字段设为NOT NULL；后续即使你重写属性为string?，如果没有同步修改EF Core的模型元数据，迁移检测逻辑也不会识别到变更。

无新增迁移、无手写SQL的实现方案 #

不需要生成新迁移，也不需要手写SQL改表，按以下两步配置即可：

1. 调整DbContext中的模型配置逻辑，直接通过EF Core元数据接口设置字段可空，优先级高于Identity的默认配置：

public class AppDbContext : IdentityDbContext<User, Role, Guid>
{
    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);
        
        // 直接修改属性底层元数据，绕过Identity的配置锁定
        var phoneNumberProperty = builder.Entity<User>()
            .FindProperty(nameof(IdentityUser<Guid>.PhoneNumber));
        if (phoneNumberProperty != null)
        {
            phoneNumberProperty.SetIsNullable(true);
            // 移除非空约束的关联注解，避免运行时校验拦截
            phoneNumberProperty.RemoveAnnotation("Relational:IsRequired");
        }
    }
}

2. 在服务注册阶段关闭Identity内置的手机号必填校验，避免接口请求阶段触发数据验证错误：

builder.Services.AddIdentity<User, Role>(options =>
{
    options.User.RequirePhoneNumber = false;
    options.SignIn.RequireConfirmedPhoneNumber = false;
})
.AddEntityFrameworkStores<AppDbContext>();

配置说明：以上修改是在EF Core运行时的模型映射层标记字段为可空，EF Core不会再对该字段执行非空校验，也不会抛出模型与表结构不匹配的错误。如果当前数据库中PhoneNumber字段已经允许空值，配置后可以直接正常写入空值；如果数据库中该字段还是NOT NULL约束，只要业务逻辑中不会实际传入null值，就不会触发数据库层面的报错，完全不需要修改现有表结构。

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