直接用 whereBetween() 即可，需确保边界值类型一致、字段为可比较类型（非 JSON/TEXT），避免传字符串到 INT 字段或在 Collection 上调用；日期查询需注意时间精度，推荐用 Carbon::today() 和 Carbon::tomorrow() 配合 >= 与 < 实现全天覆盖。
Where Between 在 Eloquent 中怎么写才不报错
直接用 whereBetween() 就行，但必须确保两个边界值类型一致、字段可比较，且数据库字段不是 JSON 或 TEXT 类型（否则可能全表扫描或结果异常）。Laravel 8+ 默认对 whereBetween() 做了 SQL 注入防护，但传入变量仍需确认来源可信。
常见错误现象：SQLSTATE[HY000]: General error: 1366 Incorrect integer value —— 多因传入字符串如 "2024-01-01" 到 INT 字段；或 Call to undefined method whereBetween() —— 实际是模型没继承 Illuminate\Database\Eloquent\Model，或写在非 Query Builder 上（比如误调用在 Collection 上）。
- 只支持数字、日期、字符串等原生可比较类型，不支持数组或对象
- 边界值包含端点（闭区间），
whereBetween('age', [18, 25])会查出 age=18 和 age=25 的记录 - 若字段是 MySQL
DATETIME，推荐用 Carbon 实例：whereBetween('created_at', [now()->subWeek(), now()]) - 避免对函数字段使用，例如
whereBetween(DB::raw('DATE(created_at)'), [...])会失效 —— 改用whereRaw()
日期范围查询为什么查不到当天的数据
本质是时间精度问题。MySQL 的 DATETIME 默认精确到秒，而 PHP Carbon::today() 返回的是 2024-05-20 00:00:00，如果想包含全天，上界不能写成 Carbon::today()，得写成 Carbon::tomorrow() 或显式设为 23:59:59。
更安全的做法是用开区间语义规避时间截断风险：
立即学习“PHP免费学习笔记（深入）”；
$start = Carbon::today();
$end = Carbon::tomorrow();
User::where('created_at', '>=', $start)
->where('created_at', '<', $end)
->get();
-
whereBetween()对日期容易漏数据，尤其当字段含时分秒时 - 用
whereDate()可绕过时间部分：whereDate('created_at', '2024-05-20')，但它无法走索引（除非加函数索引） - PostgreSQL 用户注意：
whereBetween()在 timestamptz 字段上会自动时区转换，确保 APP_TIMEZONE 和 DB 时区一致
Where Between 性能差？检查这几个地方
不是 whereBetween() 本身慢，而是底层 SQL 没走索引或数据量大时执行计划退化。最常被忽略的是字段没索引、类型隐式转换、或用了表达式包裹字段。
- 确保查询字段有单列索引或复合索引前缀，例如
created_at单独建索引 - 避免写成
whereBetween(DB::raw('UNIX_TIMESTAMP(created_at)'), [...])—— 函数导致索引失效 - 大表分页慎用：
whereBetween('id', [100000, 100100])比offset/limit更稳定，但前提是 id 连续且无删改 - 用
explain看执行计划：关注type是否为range，key是否命中索引
需要动态构造多个 Between 条件怎么办
Eloquent 不支持链式多个 whereBetween() 同字段（后一个会覆盖前一个），必须合并逻辑或拆成 AND 条件。真实业务中常遇到「按金额分档统计」或「多时间段并集查询」，这时不能硬套单个 whereBetween()。
例如查「订单金额在 100–500 或 1000–2000」：
Order::where(function ($q) {
$q->whereBetween('amount', [100, 500])
->orWhereBetween('amount', [1000, 2000]);
})->get();
- 多个独立区间必须包在
where(...)闭包里，否则orWhereBetween()会和外层条件形成 OR 逻辑，破坏预期 - 若区间来自用户输入，务必校验数组长度为 2 且左值 ≤ 右值，否则
whereBetween('x', [5, 1])生成的 SQL 永远不匹配 - 极端情况（如 20+ 区间）建议改用
whereRaw()拼接CASE WHEN或临时表，避免 SQL 过长触发 max_allowed_packet
真正难的不是写对语法，而是想清楚“边界是否包含 NULL”“时区是否对齐”“索引是否生效”。这些细节一漏，查出来的数据就 quietly 错了。
