分组查询每日数据出现空值的核心原因是聚合函数遇无记录返回null且group by不补全缺失日期；需用??0或coalesce兜底，并手动补全日期范围，同时确保select与group by字段严格对应。
分组查询每日数据出现空值，核心问题不在“日期是否为空”，而在于聚合字段（如 sum()、count()）遇到无匹配记录时返回 NULL，以及 GROUP BY DATE(created_at) 本身不会自动补全“缺失日期”——Laravel 不会凭空生成某天的数据行。
聚合结果为 NULL 时安全取默认值
当某天没有订单、没有日志或没有用户行为，sum('amount') 或 count() 就返回 NULL，直接参与运算或 JSON 输出会出错。
- PHP 层兜底：用空合并操作符
?? 0，最简洁可靠$dailySales = Order::selectRaw('DATE(created_at) as date')->selectRaw('SUM(amount) as total')->groupBy('date')->get()->mapWithKeys(fn($item) => [$item->date => $item->total ?? 0]); - 数据库层兜底（需明确类型）：用
COALESCE，但注意它会让 Eloquent 返回原生数组而非模型对象->selectRaw('DATE(created_at) as date, COALESCE(SUM(amount), 0) as total') - 避免链式陷阱：不要写
->sum('amount') * 1.1，一旦sum()是NULL，整个表达式变成NULL，乘法不报错但结果无效
让“没数据的日期”也出现在结果里
原生 SQL 和 Eloquent 的 GROUP BY 只返回有数据的日期。若要展示连续 7 天、30 天的完整曲线（含零值），必须手动补全日期范围。
- 先查出有数据的日期聚合结果，转为键值对：
collect($raw)->pluck('total', 'date')->all() - 生成目标日期区间（如近 7 天）：
collect(range(0, 6))->map(fn($i) => today()->subDays($i)->toDateString()) - 合并：遍历日期列表，查字典取值，不存在则填 0
$chartData = $dates->mapWithKeys(fn($date) => [$date => $dataByDate[$date] ?? 0]); - 更进一步可封装成辅助方法，或使用 Laravel 的
when()+ 日期生成器组合复用
GROUP BY 字段与 SELECT 字段必须严格对应
MySQL 8.0+ 严格模式下，如果写 select('DATE(created_at)', 'status')->groupBy('DATE(created_at)')，而 status 不在 GROUP BY 列表中，会直接报错 Expression #2 of SELECT list is not in GROUP BY clause。
- 只选分组字段和聚合字段：如
selectRaw('DATE(created_at) as date')->selectRaw('COUNT(*) as count')->groupBy('date') - 避免
select('*')配groupBy：语义错误，结果不可靠，不同 MySQL 版本行为不一致 - 若真需关联状态统计（比如每日“成功/失败”数量），改用条件聚合：
selectRaw('DATE(created_at) as date')->selectRaw('SUM(CASE WHEN status = "success" THEN 1 ELSE 0 END) as success_count')
空值参数导致整条查询无结果？检查 where 条件是否被意外激活
比如搜索页带日期筛选：->when($request->start_date, fn($q, $d) => $q->whereDate('created_at', '>=', $d))。若 $request->start_date 是空字符串或 null，when() 不执行，没问题；但若误用 where() 硬塞，就会变成 WHERE created_at >= NULL，整条查询返回空。
- 所有外部输入的筛选条件，务必用
filled()显式校验：if ($request->filled('start_date')) { ... } - 日期类字段建议额外验证格式：
Carbon::createFromFormat('Y-m-d', $date)捕获解析异常 - 调试时可用
toSql()查看最终 SQL，确认条件是否如预期生成
