如何在EF Core中内联查询参数？

EF Core自带的ToQueryString方法生成的SQL会用@p1、@p2这类占位符，默认不支持直接把参数值内嵌进去。要是你只是用来调试或者跟踪查询性能，完全可以自己写个扩展方法来实现：

自定义扩展方法实现参数内联 #

using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Query;
using Microsoft.EntityFrameworkCore.Storage;

public static class QueryableExtensions
{
    public static string ToQueryStringWithInlineParameters<T>(this IQueryable<T> query)
    {
        // 获取EF Core生成的关系型命令对象
        var relationalCommand = query.GetRelationalCommand();
        // 获取查询的参数值集合
        var parameterValues = query.GetParameterValues();
        
        var sql = relationalCommand.CommandText;
        
        // 遍历所有参数，替换占位符为实际值
        foreach (var parameter in relationalCommand.Parameters)
        {
            if (parameterValues.TryGetValue(parameter.InvariantName, out var value))
            {
                string formattedValue;
                
                // 针对不同数据类型做格式化处理
                switch (value)
                {
                    case string str:
                        formattedValue = $"'{str.Replace("'", "''")}'"; // 转义字符串里的单引号，避免SQL语法错误
                        break;
                    case DateTime dateTime:
                        formattedValue = $"'{dateTime:yyyy-MM-dd HH:mm:ss}'"; // 统一日期格式
                        break;
                    case null:
                        formattedValue = "NULL";
                        break;
                    default:
                        formattedValue = value.ToString();
                        break;
                }
                
                sql = sql.Replace($"@{parameter.InvariantName}", formattedValue);
            }
        }
        
        return sql;
    }
    
    // 辅助方法：获取查询的参数值
    private static IReadOnlyDictionary<string, object> GetParameterValues<T>(this IQueryable<T> query)
    {
        var queryContext = query.Provider.CreateQuery<T>(query.Expression).GetQueryContext();
        var parameterValues = new Dictionary<string, object>();
        
        foreach (var param in queryContext.ParameterValues)
        {
            parameterValues.Add(param.Key, param.Value);
        }
        
        return parameterValues;
    }
}

怎么用这个方法 #

直接在你的IQueryable对象上调用扩展方法就行：

var userQuery = dbContext.Users.Where(u => u.Age > 18 && u.Email.Contains("@example.com"));
var inlineSql = userQuery.ToQueryStringWithInlineParameters();

重要注意事项 #

• 这种方式只适合调试、性能跟踪场景，绝对不能在生产环境用！直接内联参数会带来SQL注入风险，生产环境必须用参数化查询。
• 上面的代码只是基础实现，不同数据库（比如SQL Server、MySQL）对数据格式的要求可能不一样，你可能需要根据自己用的数据库调整格式化逻辑。
• 这个方法依赖EF Core的内部API，不同EF Core版本可能有兼容性问题，使用前记得在对应版本上测试。

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