FreeSql 中子查询参数化的正确使用方式

在使用 FreeSql 进行数据库操作时，子查询和参数化查询是常见的需求。本文将详细介绍如何正确处理子查询中的参数传递问题，以及在使用自动参数化功能时的注意事项。

子查询参数传递问题

当我们在 FreeSql 中使用子查询时，可能会遇到"必须声明标量变量"的错误。这是因为子查询中的参数需要正确传递到最终的 SQL 语句中。

错误示例

var query = context.Select<Users>().As("u")
    .Where(s => s.Status > 0)
    .Where("u.Tel like @Tel", new { Tel = "%188%" })
    .WithTempQuery(s => new { UserId = s.UserId });

// 这里会报错：必须声明标量变量 "@Tel"
var anyMap = context.Select<UserRoleMap>()
    .Where(s => query.Any(u => u.UserId == s.UserId))
    .ToList();

正确解决方案

正确的做法是使用 WithParameters 方法，并且需要将参数放在最终执行的查询上：

var dbpars = new List<DbParameter>()
{
    new SqlParameter { ParameterName = "Tel", Value = "%188%" }
};

var query = context.Select<Users>().As("u")
    .Where(s => s.Status > 0)
    .Where("u.Tel like @Tel")
    .WithTempQuery(s => new { UserId = s.UserId });

// 参数放在最终查询上
var anyMap = context.Select<UserRoleMap>()
    .Where(s => query.Any(u => u.UserId == s.UserId))
    .WithParameters(dbpars)
    .ToList();

自动参数化功能的使用

FreeSql 提供了自动参数化功能（通过 UseGenerateCommandParameterWithLambda(true) 启用），但在使用时也需要注意参数传递的顺序。

常见错误

当同时使用自动参数化和手动参数化时，如果顺序不当，可能会出现"必须声明标量变量"的错误：

var dbpars = new List<DbParameter>()
{
    new SqlParameter { ParameterName = "Tel", Value = "%188%" },
    new SqlParameter { ParameterName = "UserIds", Value = new[] { 1, 2, 3 } }
};

var request = new
{
    NickName = "hello",
    Status = 1,
};

// 这里可能会报错：必须声明标量变量 "@exp_0"
var data = context.Select<Users>().As("u")
    .Where(s => s.Status == request.Status)
    .Where(s => s.NickName == request.NickName)
    .Where("u.UserId in @UserIds")
    .WithParameters(dbpars)
    .ToList();

正确使用方式

解决方法是确保 WithParameters 放在查询链的最前面：

var data = context.Select<Users>().As("u")
    .WithParameters(dbpars)  // 参数放在前面
    .Where(s => s.Status == request.Status)
    .Where(s => s.NickName == request.NickName)
    .Where("u.UserId in @UserIds")
    .ToList();

总结

1. 对于子查询中的参数，必须将 WithParameters 放在最终执行的查询上
2. 当使用自动参数化功能时，手动参数应该放在查询链的最前面
3. 参数传递的顺序会影响查询的正确性
4. 对于复杂的查询场景，建议先构建查询表达式，最后再添加参数并执行

通过遵循这些规则，可以避免 FreeSql 中子查询参数化相关的常见问题，编写出更加健壮的数据库访问代码。