Laravel中使用union合并Eloquent查询后分页失效的问题咨询

当前写法的两处逻辑错位直接导致分页失效、返回全量结果：

• 链式调用位置错误：在$queryA->union($queryB)之后追加的where("A", "=", "search")，仅会作用于第一个子查询$queryA，完全不会对合并后的全量结果生效
• 查询结构不满足SQL Server语法要求：带UNION的查询如果不包裹外层查询壳，直接拼接分页用的OFFSET/FETCH语句会触发语法错误，Laravel无法正确生成分页逻辑，最终回退为返回全量结果

完全可以通过Eloquent实现合并结果集的分页，不需要手动调用get()拉取全量数据。核心思路是把UNION生成的合并结果当作基础子查询，所有搜索、排序、分页逻辑都作用在外层查询壳上，示例代码如下：

// 1. 准备两个结构完全对齐的子查询，不提前加公共筛选条件
$queryA = ModelA::query()->selectRaw('A, B, C');
$queryB = ModelB::query()->selectRaw('A, D as B, C');

// 2. 生成UNION合并的基础查询，无重复行时优先用unionAll，性能远优于去重的union
$unionBase = $queryA->unionAll($queryB);

// 3. 把整个合并结果包为外层子查询，所有公共逻辑在外层处理
$resultQuery = ModelA::query()
    ->fromSub($unionBase, 'merged_result') // 给子查询指定别名，满足SQL语法要求
    ->where('A', '=', 'search') // 搜索条件作用于全量合并结果
    ->orderBy('A'); // 排序作用于全量合并结果，实现不同数据源的行交错排序

// 4. 直接调用paginate即可，不会拉取全量数据
return $resultQuery->paginate(5);

• 该结构下Laravel会自动生成两类兼容SQL Server的SQL语句：
  • 计数SQL：自动对全量合并结果做行数统计，用来计算总页数、渲染分页导航
  • 取数SQL：仅查询当前页需要的指定数量数据，百万级结果集下也不会出现内存溢出
• 实操注意点：
  • 两个UNION子查询的字段顺序、数据类型必须严格对齐，否则会触发数据库类型匹配错误
  • 不要在UNION子查询内部加ORDER BY，否则会触发SQL Server语法报错，所有排序逻辑必须加在外层查询上
  • 确认两个子查询无重复行时，优先使用unionAll()替代union()，可省去数据库去重的额外开销，大幅提升百万级结果集的查询性能

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