EF Core查询转换失败：如何解决ToString()无法翻译的问题？

问题根源 #

EF Core无法将.NET原生的ToString()方法直接转换为对应的SQL语句，尤其是针对数值类型（Amount）和枚举类型（MandateApprovalStatus）的转换调用，这会导致查询无法在数据库端执行，触发InvalidOperationException。

方案1：使用EF Core内置字符串转换函数 #

EF Core 3.0+提供了EF.Functions.ToString()方法，可直接将数据库中的数值、枚举类型转换为字符串，能被正确解析为SQL：

var query = _dbContext.Mandates
    .Where(m => EF.Functions.ToString(m.Amount).Contains(searchKeyword) 
             || EF.Functions.ToString(m.MandateApprovalStatus).Contains(searchKeyword));

var totalCount = await query.CountAsync();

如果MandateApprovalStatus是枚举类型，确保EF Core已正确映射该枚举（默认数值映射或显式字符串映射均可），EF.Functions.ToString()会自动处理转换逻辑。

方案2：将枚举直接映射为数据库字符串类型 #

在实体配置中，把MandateApprovalStatus枚举直接映射为数据库字符串字段，后续查询无需额外转换：

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
    modelBuilder.Entity<Mandate>()
        .Property(m => m.MandateApprovalStatus)
        .HasConversion<string>(); // 将枚举以字符串形式存储到数据库
}

之后查询时可直接对比枚举的字符串值（仍建议搭配EF.Functions.ToString()确保兼容性）：

var query = _dbContext.Mandates
    .Where(m => EF.Functions.ToString(m.Amount).Contains(searchKeyword)
             || EF.Functions.ToString(m.MandateApprovalStatus).Contains(searchKeyword));

方案3：转换查询条件而非字段 #

如果搜索关键词针对数值类型Amount，可尝试将关键词转换为数值后直接对比，避免字符串转换开销：

var query = _dbContext.Mandates.AsQueryable();

if (decimal.TryParse(searchKeyword, out decimal amountSearch))
{
    query = query.Where(m => m.Amount == amountSearch);
}
else
{
    query = query.Where(m => EF.Functions.ToString(m.MandateApprovalStatus).Contains(searchKeyword));
}

var totalCount = await query.CountAsync();

方案4：调用数据库原生转换函数（特定数据库） #

如果使用SQL Server等特定数据库，可直接调用CAST/CONVERT等原生函数，通过EF.Functions实现：

// SQL Server示例：用CAST将数值转为字符串
var query = _dbContext.Mandates
    .Where(m => EF.Functions.Like(EF.Functions.Cast<string>(m.Amount), $"%{searchKeyword}%")
             || EF.Functions.Like(EF.Functions.ToString(m.MandateApprovalStatus), $"%{searchKeyword}%"));

注意：该方式绑定特定数据库，会降低代码可移植性。

关键注意事项 #

• 禁止在LINQ查询中使用.NET原生ToString()，EF Core无法将其转换为SQL，新版本会直接报错，旧版本可能触发低效的客户端评估。
• 优先使用EF.Functions下的方法，这类方法专为SQL转换设计，兼容性和性能更优。

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