FreeSql中UnionAll查询的参数化共享问题解析

在使用FreeSql进行数据库操作时，UnionAll查询是一个常用的功能，但在参数化查询场景下可能会遇到一些特殊问题。本文将深入分析这一问题及其解决方案。

问题现象

当我们在FreeSql中执行包含UnionAll的查询时，特别是同时启用了参数化查询功能（UseGenerateCommandParameterWithLambda(true)），可能会出现参数命名冲突的情况。例如：

SELECT a."id", a."name", a."companyid", a."teamid", a."type" 
FROM ( SELECT a."id", a."name", a."companyid", a."teamid", a."type" 
    FROM "roles" a 
    WHERE (a."companyid" = @exp_0) AND (a."teamid" = @exp_1) 
    UNION ALL 
    SELECT a."id", a."name", a."companyid", a."teamid", a."type" 
    FROM "roles" a 
    WHERE (a."companyid" = 0) AND (a."type" = @exp_0) ) a 
ORDER BY a."companyid", a."id" 
limit 10

可以看到，两个子查询中的参数都被命名为@exp_0，这显然会导致参数值传递错误。

问题原因

FreeSql默认情况下会对Lambda表达式中的常量值进行参数化处理，这在大多数场景下是有利的，可以防止SQL注入并提高查询性能。但在UnionAll查询中，多个查询部分会共享相同的参数命名空间，导致参数名冲突。

解决方案

FreeSql提供了WithParameters方法来显式指定参数共享策略。以下是正确的使用方式：

var data = fsql.Select<Roles>()
    .WhereIf(filter.CompanyId > 0, s => s.CompanyId == filter.CompanyId)
    .WhereIf(filter.TeamId > 0, s => s.TeamId == filter.TeamId)
    .UnionAll(defualtRoles.WithParameters())
    .Count(out var _)
    .OrderBy(s => s.CompanyId)
    .OrderBy(s => s.Id)
    .Page(filter.PageIndex, filter.PageSize)
    .ToList<Roles>();

关键点是在UnionAll的子查询上调用WithParameters()方法，这样FreeSql会正确处理参数命名，避免冲突。

最佳实践建议

1. 在使用UnionAll时，总是考虑使用WithParameters()方法来明确参数共享策略
2. 对于复杂的联合查询，可以先分别构建各个子查询，再使用UnionAll组合
3. 在调试阶段，检查生成的SQL语句，确认参数命名是否符合预期
4. 对于枚举类型的参数，FreeSql会默认转换为对应的数值，不需要额外处理

通过正确使用WithParameters方法，可以确保UnionAll查询在参数化场景下正常工作，同时保持SQL注入防护和查询性能优化的优势。