本文详解 laravel eloquent 中筛选“当前时间落在数据库中两个时间字段之间”的正确写法，指出常见错误用法（如误用 where() 链式调用传递多个参数），并提供安全、高效、可读性强的解决方案。
本文详解 laravel eloquent 中筛选“当前时间落在数据库中两个时间字段之间”的正确写法，指出常见错误用法（如误用 where() 链式调用传递多个参数），并提供安全、高效、可读性强的解决方案。
在 Laravel 开发中，一个典型需求是：获取当前时间（NOW()）处于 publication_start_at 与 publication_end_at 之间的所有公告记录。但许多开发者会误将 PHP 的逻辑判断直接套用到 Eloquent 查询中，导致查询失效或报错。
例如，原始代码存在多处关键问题：
$today = date('Y-m-d H:i:s');
$official_message = OfficialMessage::all() // ❌ 错误：先加载全部数据到内存再过滤！
->where($today, '>=', 'publication_start_at', '&&', $today, '<=', 'publication_end_at') // ❌ 语法非法：where() 不支持此参数格式
->sortBy('publication_start_at');⚠️ 主要问题解析
- OfficialMessage::all() 是致命性能陷阱：它会先执行 SELECT * FROM official_messages，将全部记录载入 PHP 内存，再用 Collection 方法过滤——完全绕过数据库索引，数据量稍大即崩溃；
- where() 参数误用：Eloquent 的 where() 方法不接受 $value, $operator, $column 混合多组逻辑的写法，更不支持 '&&' 这类字符串连接符；
- PHP 时间与数据库时间不同步风险：用 date('Y-m-d H:i:s') 生成时间再传入查询，可能因时区、精度或服务器时间偏差导致边界判断不准。
✅ 正确做法：使用数据库原生时间函数 + 链式 where 条件
推荐使用 Eloquent 的 whereBetween() 或组合 where()，让数据库完成时间比较（高效、精准、可利用索引）：
✅ 方案一（推荐）：使用 whereRaw 调用 NOW()
use App\Models\OfficialMessage;
$messages = OfficialMessage::whereRaw('NOW() BETWEEN publication_start_at AND publication_end_at')
->orderBy('publication_start_at')
->get();✅ 方案二：显式双条件（语义更清晰）
$messages = OfficialMessage::where('publication_start_at', '<=', DB::raw('NOW()'))
->where('publication_end_at', '>=', DB::raw('NOW()'))
->orderBy('publication_start_at')
->get();? 提示：DB::raw('NOW()') 确保调用 MySQL 的当前时间函数，避免 PHP 与数据库时区不一致；同时 WHERE 条件下推至 SQL 层，极大提升性能。
✅ 方案三（若需支持 PostgreSQL / SQLite）：使用 now() 或 datetime('now')
// PostgreSQL
->whereRaw("NOW() BETWEEN publication_start_at AND publication_end_at")
// SQLite
->whereRaw("datetime('now') BETWEEN publication_start_at AND publication_end_at")? 注意事项与最佳实践
- ✅ 永远避免 ::all()->where(...)：这属于 N+1 反模式，应始终用 query()->get() 在数据库层过滤；
- ✅ 确保时间字段为 DATETIME 或 TIMESTAMP 类型，且索引合理（如对 publication_start_at, publication_end_at 建联合索引可进一步加速范围查询）；
- ✅ 考虑时区一致性：在 config/database.php 中配置 'timezone' => '+00:00'，并在模型中统一使用 UTC 存储时间；
- ⚠️ 若业务要求“包含边界”，确认数据库字段是否允许 NULL；建议对 publication_end_at 设置默认值（如 9999-12-31 23:59:59）或增加非空校验。
✅ 完整修复后的控制器示例
<?php
namespace App\Http\Controllers;
use App\Models\OfficialMessage;
use Illuminate\Http\Request;
class MessageController extends Controller
{
public function show()
{
$messages = OfficialMessage::whereRaw('NOW() BETWEEN publication_start_at AND publication_end_at')
->orderBy('publication_start_at')
->get();
return view('front.pages.message', [
'messages' => $messages,
]);
}
}通过以上重构，查询从低效的内存遍历变为高效的数据库索引扫描，逻辑清晰、可维护性强，且具备良好的跨环境兼容性与时序鲁棒性。
