Laravel获取当月记录异常：查询结果与实际数据不符问题排查

数据库内仅有1条符合当月条件的记录，但通过Laravel查询得到的统计结果却不正确。

问题代码 #

$data = UserData::select(
    DB::raw("count(phone) as total")
)
    ->whereMonth('creation_date', Carbon::now()->month)
    ->get();
return view('kpidata', compact('data'));

问题原因 #

原代码仅通过whereMonth筛选了月份，未限制年份范围。这会导致查询匹配所有年份中对应月份的记录，而非实际需要的当前年份的当月记录。此外，若Laravel时区配置与数据库时区不一致，也可能引发日期解析偏差，导致统计错误。

解决方法 #

方法一：同时过滤年份与月份

在查询中新增年份筛选条件，确保仅匹配当前年份的当月记录：

$data = UserData::select(DB::raw("count(phone) as total"))
    ->whereMonth('creation_date', Carbon::now()->month)
    ->whereYear('creation_date', Carbon::now()->year)
    ->get();

方法二：使用日期范围匹配

通过whereBetween指定当月的完整日期区间，精准锁定目标记录：

$startOfMonth = Carbon::now()->startOfMonth();
$endOfMonth = Carbon::now()->endOfMonth();

$data = UserData::select(DB::raw("count(phone) as total"))
    ->whereBetween('creation_date', [$startOfMonth, $endOfMonth])
    ->get();

方法三：使用日期比较筛选

通过whereDate分别限定当月的起始与结束日期，逻辑清晰直观：

$data = UserData::select(DB::raw("count(phone) as total"))
    ->whereDate('creation_date', '>=', Carbon::now()->startOfMonth())
    ->whereDate('creation_date', '<=', Carbon::now()->endOfMonth())
    ->get();

另外，建议检查config/app.php中的timezone配置，确保其与数据库时区保持一致，避免因时区差异导致的日期判断错误。

内容的提问来源于stack exchange，提问作者ayesha maqsood