在使用 Laravel Eloquent 或 Query Builder 进行多表关联分组查询时，若为多个字段指定相同别名（如 e.id as branch_code 和 e.code as branch_code），会导致 SQL 语法错误或分组逻辑异常；正确做法是确保每个 SELECT 字段具有唯一别名，并在 GROUP BY 中严格对应非聚合字段。
在使用 laravel eloquent 或 query builder 进行多表关联分组查询时，若为多个字段指定相同别名（如 `e.id as branch_code` 和 `e.code as branch_code`），会导致 sql 语法错误或分组逻辑异常；正确做法是确保每个 select 字段具有唯一别名，并在 group by 中严格对应非聚合字段。
在实际开发中，当需要按业务维度（如分支机构 code_branch）对交易数据进行统计汇总时，常通过 GROUP BY 实现分组计数。但一个典型错误是：在 SELECT 子句中为不同字段赋予重复别名，例如：
->select(
'a.status as status',
'b.name as customer_name',
'e.name as branch_name',
'c.name as company_name',
'd.name as project_name',
'f.name as region_name',
'e.code as branch_code', // ✅ 正确：表示分支编码
'e.id as branch_code', // ❌ 错误：与上一行别名冲突！
DB::raw('COUNT(a.id) as total_transaksi')
)
->groupBy(
'e.id',
'b.name',
'e.name',
'e.code',
'a.status',
'c.name',
'd.name',
'f.name'
)
该写法会引发两个问题：
- SQL 语法层面：数据库无法区分 branch_code 到底指向 e.code 还是 e.id，可能导致查询失败或结果不可预期；
- GROUP BY 语义不一致：e.id 和 e.code 逻辑上应共同标识分支，但若仅按 e.id 分组而 SELECT 中混用别名，易造成分组粒度混乱（尤其当 e.id 与 e.code 并非一一映射时）。
✅ 正确修复方式如下：
->select(
'a.status as status',
'b.name as customer_name',
'e.name as branch_name',
'c.name as company_name',
'd.name as project_name',
'f.name as region_name',
'e.code as branch_code', // 表示分支编码（业务标识）
'e.id as branch_id', // 表示分支主键（技术标识）→ 别名唯一且语义清晰
DB::raw('COUNT(a.id) as total_transaksi')
)
->groupBy(
'e.id', // 必须包含所有非聚合、非常量 SELECT 字段
'e.code', // 若需按 code 分组，此处必须显式列出
'a.status',
'b.name',
'e.name',
'c.name',
'd.name',
'f.name'
)
⚠️ 关键注意事项：
- 别名唯一性：每个 AS xxx 后的别名在整个查询中必须唯一；
- GROUP BY 完整性：MySQL 5.7+ 严格模式下，SELECT 中所有非聚合字段（即未被 COUNT/SUM/AVG 等包裹的字段）必须全部出现在 GROUP BY 子句中；
- 语义一致性：若业务要求“按 code_branch 分组”，建议优先以 e.code 为主分组键，并确认 e.code 的唯一性；若存在重复 code，则需联合 e.id 或其他字段保证分组准确；
- 调试技巧：可先移除 ->groupBy()，执行 ->toSql() 查看原始 SQL，验证字段别名与结构是否合理。
总结：GROUP BY 不是“不能工作”，而是因别名冲突和分组字段缺失导致逻辑失效。保持 SELECT 字段别名唯一、GROUP BY 列表完备且语义明确，是构建可靠聚合查询的基础。
