laravel中对关联数据做时间范围筛选需严格区分主表与关联表条件：用wherehas嵌套wherebetween处理关联表日期，主表条件放外层；动态参数用when(filled())配合use显式传递；日期字段须统一用carbon::startofday()等方法截断以确保索引生效。
要在 Laravel 中对关联数据做时间范围筛选，比如“查出所有在2024年下单且订单内有商品创建于2023年的用户”，就必须拆解主表与关联表的条件边界——写错一层嵌套，整条 SQL 就会漏数据或报错。
用 whereHas 套 whereBetween 筛关联表日期
第一步：调用 whereHas，传入关联关系名和闭包；
第二步：在闭包里用 whereBetween 指定关联表的时间字段和范围；
第三步：确保闭包参数是 $query，不是外部 $q 或 $builder——【闭包内必须操作传入的 $query 参数，否则条件不生效】；
例如：User::whereHas('orders', function ($query) { $query->whereBetween('created_at', ['2024-01-01', '2024-12-31']); })->get();
主表+关联表双时间范围组合查询
这种场景常见于运营分析：“找出 2024 年注册、且首单发生在 2024 年 Q1 的用户”。主表条件和关联表条件不能混写。
方法一：主表时间放外层，关联表时间放 whereHas 闭包内
User::whereBetween('created_at', ['2024-01-01', '2024-12-31'])→whereHas('orders', function ($q) { $q->whereBetween('created_at', ['2024-01-01', '2024-03-31']); })→get();
方法二：用 join() 替代 whereHas，显式控制连接类型和字段前缀
DB::table('users')→join('orders', 'users.id', '=', 'orders.user_id')→whereBetween('users.created_at', ['2024-01-01', '2024-12-31'])→whereBetween('orders.created_at', ['2024-01-01', '2024-03-31'])→select('users.*')→distinct()→get();
【必须加 distinct()，否则一个用户多笔订单会导致重复返回】
可选时间参数的动态嵌套构建
前端可能只传 start_date、只传 end_date，或都不传。硬写 if 判断会让代码膨胀三层以上。
① 先定义基础查询：$query = User::query();
② 对主表时间字段用 when(filled()) 控制：→when($request->filled('start_date'), fn ($q) => $q->whereDate('created_at', '>=', $request->start_date))；
③ 对关联表时间字段，同样用 when，但必须嵌套在 whereHas 内部：→whereHas('orders', function ($q) use ($request) { $q->when($request->filled('order_after'), fn ($sub) => $sub->where('created_at', '>=', $request->order_after)); });
注意：不要把 $request 直接塞进外层闭包再传给 whereHas——【whereHas 的闭包不自动继承外层 use 变量，必须显式 use】；
避免日期字段类型引发的隐式转换失败
如果关联表的 created_at 是 DATE 类型，但传入 '2024-01-01 00:00:00' 这样的 datetime 字符串，MySQL 可能放弃走索引。
正确做法是统一截断：whereBetween('created_at', [Carbon::parse($from)->startOfDay(), Carbon::parse($to)->endOfDay()]);
这一步不能省——哪怕你确认字段是 DATE，也要显式调用 startOfDay()，否则线上环境换数据库版本后可能突然变慢。
