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

在使用 FreeSql 进行数据库操作时，子查询和嵌套查询是常见的场景。然而，许多开发者在使用过程中会遇到"必须声明标量变量"的错误提示。本文将深入分析这一问题的原因，并提供完整的解决方案。

问题现象

当开发者尝试在 FreeSql 中执行包含子查询或嵌套查询的操作时，可能会遇到以下错误：

1. 简单查询和 JOIN 操作正常执行
2. 涉及子查询或嵌套查询时出现"必须声明标量变量"的错误
3. 生成的 SQL 语句中参数未被正确传递

问题根源

这个问题的根本原因在于 FreeSql 的参数传递机制。在子查询场景下，参数需要从外层查询传递到内层查询，而开发者通常容易将参数放在内层查询上，导致外层查询无法获取这些参数。

解决方案

基础解决方案

正确的做法是将参数放在最终执行的查询上，而不是中间的子查询：

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

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

var anyMap = context.Select<UserRoleMap>()
    .Where(s => query.Any(u => u.UserId == s.UserId))
    .WithParameters(dbpars)
    .ToList();

自动参数化场景

当开启自动参数化(UseGenerateCommandParameterWithLambda(true))时，需要注意混合使用 Lambda 表达式和原生 SQL 的情况：

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,
};

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. 参数位置：始终将参数放在最终执行的查询上，而不是中间的子查询
2. 参数顺序：在使用自动参数化时，将WithParameters放在查询链的前面
3. 参数命名：确保参数名称与 SQL 中的占位符完全匹配
4. 参数类型：使用正确的参数类型，特别是数组参数

总结

FreeSql 在处理复杂查询时，参数传递需要特别注意作用域问题。通过遵循上述最佳实践，开发者可以避免"必须声明标量变量"的错误，确保查询能够正确执行。理解 FreeSql 的参数传递机制是解决这类问题的关键，希望本文能够帮助开发者更好地使用 FreeSql 进行数据库操作。