EF Core 8中带参数的Database.SqlQuery<T>原生SQL查询能否预编译？

针对你用Database.SqlQuery<T>执行带BETWEEN参数的复杂原生SQL、每次调用都重复解析的问题，EF Core 3.0及以上版本完全支持这类带参数原生SQL的预编译，以下是两种可行的实现方式：

1. 使用EF预编译查询API（推荐） #

通过EF.CompileAsyncQuery（同步场景用EF.CompileQuery）预编译包含原生SQL的查询逻辑，将预编译后的委托缓存起来，每次调用时仅传入参数即可，无需重新解析SQL。

示例代码：

// 预编译委托（作为静态字段缓存，确保只编译一次）
private static readonly Func<YourDbContext, DateTime, DateTime, Task<List<YourEntity>>> _precompiledSqlQuery =
    EF.CompileAsyncQuery((YourDbContext ctx, DateTime startDate, DateTime endDate) =>
        ctx.Database.SqlQuery<YourEntity>(
            "SELECT * FROM YourTable WHERE CreateTime BETWEEN @Start AND @End",
            new SqlParameter("@Start", startDate),
            new SqlParameter("@End", endDate)
        ).ToListAsync());

// 调用预编译查询
public async Task<List<YourEntity>> GetRelatedDataAsync(DateTime start, DateTime end)
{
    using var dbContext = new YourDbContext();
    return await _precompiledSqlQuery(dbContext, start, end);
}

2. 手动缓存SqlCommandDefinition #

创建包含原生SQL和参数模板的SqlCommandDefinition并缓存，每次执行时仅更新参数值即可复用查询计划：

// 缓存命令定义（静态字段）
private static readonly SqlCommandDefinition _cachedCommandDefinition = new SqlCommandDefinition(
    "SELECT * FROM YourTable WHERE CreateTime BETWEEN @Start AND @End",
    new { Start = (DateTime)default, End = (DateTime)default } // 参数模板
);

// 执行查询时传入实际参数
public async Task<List<YourEntity>> GetRelatedDataAsync(DateTime start, DateTime end)
{
    using var dbContext = new YourDbContext();
    // 替换命令定义中的参数值
    var commandDefinition = _cachedCommandDefinition.WithParameters(new { Start = start, End = end });
    return await dbContext.Database.SqlQuery<YourEntity>(commandDefinition).ToListAsync();
}

关键注意事项 #

• 预编译的核心是缓存查询结构，参数值可以动态变化，不会触发重新解析；
• 确保每次执行的SQL文本完全一致（包括参数名称、空格、大小写），否则预编译缓存会失效；
• 两种方案都要将预编译对象（委托/命令定义）作为静态成员或存入内存缓存，避免每次调用都重新编译。

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