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

在使用 FreeSql 进行数据库操作时，开发者可能会遇到一个关于 UnionAll 查询和参数化共享的常见问题。本文将通过一个实际案例，深入分析这个问题产生的原因，并提供解决方案。

问题现象

当使用 FreeSql 进行 UnionAll 查询时，如果启用了参数化查询功能（UseGenerateCommandParameterWithLambda(true)），可能会出现参数共享导致的逻辑错误。具体表现为：

1. 两个独立的查询条件被错误地共享了相同的参数名
2. 枚举类型的值被不必要地参数化
3. 最终生成的 SQL 语句逻辑与预期不符

案例重现

考虑以下场景：我们需要查询特定公司和团队的角色，同时合并默认角色。代码实现如下：

var defualtRoles = fsql.Select<Roles>()
    .Where(s => s.CompanyId == 0)
    .Where(s => s.Type == RoleType.ALl);

var filter = new { CompanyId = 1, TeamId = 2 };
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)
    .ToList();

预期生成的 SQL 应该分别对两个查询使用独立的参数，但实际生成的 SQL 却共享了参数名：

SELECT * FROM (
    SELECT * FROM "roles" WHERE ("companyid" = @exp_0) AND ("teamid" = @exp_1)
    UNION ALL
    SELECT * FROM "roles" WHERE ("companyid" = 0) AND ("type" = @exp_0)
)

问题分析

1. 参数名冲突：两个查询中的不同条件（CompanyId 和 Type）被分配了相同的参数名 @exp_0
2. 不必要的参数化：枚举值 RoleType.ALl 被参数化，而实际上可以直接使用字面值
3. 逻辑错误：参数共享导致查询条件被错误地关联

解决方案

FreeSql 提供了 WithParameters 方法来解决 UnionAll 查询中的参数共享问题：

var data = fsql.Select<Roles>()
    .WithParameters(new {
        companyId = filter.CompanyId,
        teamId = filter.TeamId,
        roleType = RoleType.ALl
    })
    .WhereIf(filter.CompanyId > 0, s => s.CompanyId == filter.CompanyId)
    .WhereIf(filter.TeamId > 0, s => s.TeamId == filter.TeamId)
    .UnionAll(
        fsql.Select<Roles>()
            .Where(s => s.CompanyId == 0)
            .Where(s => s.Type == RoleType.ALl)
    )
    .ToList();

最佳实践

1. 对于 UnionAll 查询，始终使用 WithParameters 显式定义参数
2. 对于枚举类型的条件，考虑直接使用字面值而非参数化
3. 复杂的联合查询建议拆分为多个步骤，确保每个子查询的参数独立性
4. 在生产环境中，建议检查生成的 SQL 语句是否符合预期

通过正确使用 WithParameters 方法，可以确保 UnionAll 查询中的参数独立性，避免因参数共享导致的逻辑错误。