如何调整EF Core适配PostgreSQL的查询格式以解决列不存在错误

问题场景 #

我正在使用ASP.NET Core MVC和PostgreSQL开发应用，运行以下代码时：

public async Task<IActionResult> Index()
{
    return _context.antrenorler != null 
                 ? View(await _context.antrenorler.ToListAsync()) 
                 : Problem("Entity set 'YazlabDbContext.antrenorler' is null.");
}

Entity Framework Core生成了如下SQL查询：

SELECT a.id, a.adsoyad, a."contactInfo", a.experience, a.specialties
FROM antrenorler AS a

但pgAdmin4提示列a.id不存在，数据库连接正常，仅需调整EF生成的查询格式适配PostgreSQL。

具体错误信息 #

fail: Microsoft.EntityFrameworkCore.Database.Command[20102]
      执行DbCommand失败(469ms) [参数=[], 命令类型='Text', 命令超时='30']
      SELECT a.id, a.adsoyad, a."contactInfo", a.experience, a.specialties
      FROM antrenorler AS a
fail: Microsoft.EntityFrameworkCore.Query[10100]
      遍历上下文类型为'YAZLAB2.YazlabDbContext'的查询结果时发生异常。
      Npgsql.PostgresException (0x80004005): 42703: 列 a.id 不存在

      POSITION: 8
         在 Npgsql.Internal.NpgsqlConnector.<ReadMessage>g__ReadMessageLong|223_0(NpgsqlConnector connector, Boolean async, DataRowLoadingMode dataRowLoadingMode, Boolean readingNotifications, Boolean isReadingPrependedMessage)
         在 Npgsql.NpgsqlDataReader.NextResult(Boolean async, Boolean isConsuming, CancellationToken cancellationToken)
         在 Npgsql.NpgsqlCommand.ExecuteReader(CommandBehavior behavior, Boolean async, CancellationToken cancellationToken)
         在 Npgsql.NpgsqlCommand.ExecuteReader(CommandBehavior behavior, Boolean async, CancellationToken cancellationToken)
         在 Npgsql.NpgsqlCommand.ExecuteDbDataReaderAsync(CommandBehavior behavior, CancellationToken cancellationToken)
         在 Microsoft.EntityFrameworkCore.Storage.RelationalCommand.ExecuteReaderAsync(RelationalCommandParameterObject parameterObject, CancellationToken cancellationToken)
         在 Microsoft.EntityFrameworkCore.Storage.RelationalCommand.ExecuteReaderAsync(RelationalCommandParameterObject parameterObject, CancellationToken cancellationToken)
         在 Microsoft.EntityFrameworkCore.Query.Internal.SingleQueryingEnumerable`1.AsyncEnumerator.InitializeReaderAsync(AsyncEnumerator enumerator, CancellationToken cancellationToken)
         在 Npgsql.EntityFrameworkCore.PostgreSQL.Storage.Internal.NpgsqlExecutionStrategy.ExecuteAsync[TState,TResult](TState state, Func`4 operation, Func`4 verifySucceeded, CancellationToken cancellationToken)
         在 Microsoft.EntityFrameworkCore.Query.Internal.SingleQueryingEnumerable`1.AsyncEnumerator.MoveNextAsync()
        异常数据:
          Severity: ERROR
          SqlState: 42703
          MessageText: 列 a.id 不存在
          Position: 8
          File: parse_relation.c
          Line: 3661
          Routine: errorMissingColumn
      Npgsql.PostgresException (0x80004005): 42703: 列 a.id 不存在

解决办法 #

1. 匹配实体类与数据库列的大小写 #

PostgreSQL对标识符大小写敏感，未加双引号的标识符会自动转为小写。如果你的数据库列是Id（首字母大写），EF生成的a.id（小写）就会找不到。可以通过以下方式处理：

• 数据注解方式：在实体类属性上显式指定列名

  using System.ComponentModel.DataAnnotations.Schema;
  
  public class Antrenor
  {
      [Column("Id")] // 填写数据库实际的列名
      public int Id { get; set; }
      // 其他属性...
  }
  

• Fluent API方式：在DbContext的OnModelCreating方法中配置映射

  protected override void OnModelCreating(ModelBuilder modelBuilder)
  {
      modelBuilder.Entity<Antrenor>()
          .Property(a => a.Id)
          .HasColumnName("Id"); // 匹配数据库列名
  }
  

2. 配置全局命名约定适配PostgreSQL #

如果数据库使用蛇形命名（比如antrenorler表、contact_info列），可以让EF自动生成匹配的SQL标识符：

1. 确保已安装Npgsql.EntityFrameworkCore.PostgreSQL包
2. 在DbContext的OnModelCreating中启用蛇形命名约定：

   using Npgsql.EntityFrameworkCore.PostgreSQL.Metadata;
   
   protected override void OnModelCreating(ModelBuilder modelBuilder)
   {
       // 全局将表名、列名转为蛇形小写
       modelBuilder.UseSnakeCaseNamingConvention();
   }
   

   这样EF会把实体的Id属性映射到数据库的id列，ContactInfo映射到contact_info，和PostgreSQL的命名习惯一致。

3. 确认数据库表结构 #

直接在pgAdmin中执行以下SQL，确认antrenorler表是否真的存在id列，或者列名是否为其他形式（比如ID、antrenor_id）：

SELECT column_name FROM information_schema.columns WHERE table_name = 'antrenorler';

如果列名不是id，需要调整实体类的属性映射或修改EF的查询逻辑。

4. 检查Npgsql版本兼容性 #

确保Npgsql.EntityFrameworkCore.PostgreSQL的版本与你的ASP.NET Core版本匹配，版本不兼容可能导致SQL生成异常。例如：

• ASP.NET Core 6.x 对应 Npgsql.EntityFrameworkCore.PostgreSQL 6.x
• ASP.NET Core 7.x 对应 Npgsql.EntityFrameworkCore.PostgreSQL 7.x

内容的提问来源于stack exchange，提问作者Talha Emre Ünal