.NET 8+EF Core中“Invalid column name 'AccountEmail'”错误的原因及解决

问题背景 #

我基于.NET 8、Entity Framework Core和SQL Server开发项目，已通过以下SQL脚本创建Accounts表：

CREATE TABLE [dbo].[Accounts] 
(
    [Id] INT IDENTITY (1, 1) NOT NULL,
    [AccountEmail] NVARCHAR (100) NOT NULL UNIQUE,
    [HashedPassword] NVARCHAR (200) NOT NULL,
    [DateOfBirth] DATETIMEOFFSET NOT NULL,
    [RegisterDate] DATETIMEOFFSET NOT NULL,

    CONSTRAINT [PK_Accounts] PRIMARY KEY CLUSTERED ([Id] ASC)
);
GO

对应的C#实体类如下：

public class Account : BaseModel
{
    public required string AccountEmail { get; set; }
    public required string HashedPassword { get; set; }
    public DateTimeOffset DateOfBirth { get; set; }
    public DateTimeOffset RegisterDate { get; set; }
    public User? User { get; set; }
}

执行注册逻辑时（代码如下），在AnyAsync判断邮箱是否已存在的位置抛出错误：

public async Task<AccountResponse> Register(RegisterRequest request)
{
    if (await _dbContext.Accounts.AnyAsync(x => x.AccountEmail == request.Email.ToLower()))
        // 错误在此处出现
        throw new Exception("This e-mail address is already taken!"); 

    var user = new User
                   {
                       Username = request.Username
                   };

    var account = new Account
                      {
                          AccountEmail = request.Email,
                          HashedPassword = _passwordManager.HashPassword(request.Password),
                          DateOfBirth = request.DateOfBirth,
                          RegisterDate = DateTime.UtcNow,
                          User = user
                      };

    user.Account = account;

    _dbContext.Accounts.Add(account);
    await _dbContext.SaveChangesAsync();

    return new AccountResponse
               {
                   Email = account.AccountEmail,
                   Username = user.Username,
                   Token = _tokenService.GenerateAccountToken(account.Id)
               };
}

错误现象 #

Invalid column name 'AccountEmail'

已确认数据库表列名与实体类属性名拼写一致，且已更新数据库，求问题原因及解决方法。

可能原因及解决方法 #

1. EF Core全局命名约定冲突 #

如果你的DbContext配置了全局命名转换（比如自动将驼峰命名转为下划线命名），EF会把AccountEmail解析为account_email，和数据库中的AccountEmail列名不匹配。

• 解决方法：
  • 方法一：给AccountEmail属性添加[Column]特性，强制指定列名：

    [Column("AccountEmail")]
    public required string AccountEmail { get; set; }
    

  • 方法二：移除全局命名转换配置，比如删除DbContext中类似以下的代码：

    modelBuilder.UseLowerCaseNamingConvention();
    // 或其他自定义命名约定代码
    

2. 实体映射配置错误 #

如果在DbContext的OnModelCreating方法中，对Account实体的AccountEmail属性做了错误的列名映射，也会导致该问题。

• 解决方法：
  在OnModelCreating中显式配置正确的列名映射：

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<Account>()
          .Property(a => a.AccountEmail)
          .HasColumnName("AccountEmail");
      
      // 其他映射配置...
  }
  

3. 连接字符串指向错误数据库 #

可能你的程序连接的不是你创建Accounts表的那个数据库，导致EF找不到对应列。

• 解决方法：
  检查appsettings.json（或其他配置文件）中的连接字符串，确认数据库名称、服务器地址等信息正确，并用SSMS连接目标数据库，再次验证Accounts表的AccountEmail列是否存在。

4. 数据库迁移未正确应用 #

即便你手动执行了建表脚本，若EF Core的迁移记录与实际数据库状态不匹配，也可能引发该错误。

• 解决方法：
  重新生成并应用迁移：

  # 生成新的迁移脚本
  Add-Migration FixAccountColumnMapping
  # 应用到数据库
  Update-Database
  

  或者手动确认数据库中的__EFMigrationsHistory表，确保迁移记录与实际表结构一致。

5. 数据库排序规则大小写敏感 #

如果你的SQL Server数据库使用了区分大小写的排序规则（比如SQL_Latin1_General_CP1_CS_AS），即便拼写一致，大小写不同也会导致列名匹配失败。

• 解决方法：
  • 方法一：修改实体类属性名与数据库列名大小写完全一致；
  • 方法二：将数据库排序规则改为不区分大小写的类型（比如SQL_Latin1_General_CP1_CI_AS）。

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