Laravel中DB::select执行同SQL结果与数据库控制台不一致原因排查

可能的原因及排查方案 #

1. 数据库连接不一致 #

这是最高发的情况，先确认Laravel项目.env文件中配置的数据库地址、库名、账号，和你直接执行SQL的控制台所用的连接信息完全一致。很多时候是控制台连生产库、项目连本地/测试库，数据差异导致仅返回单年结果。

2. 日期格式化占位符被参数绑定误解析 #

Laravel的查询底层默认会把SQL中%开头的字符识别为参数绑定占位符，你写的%m、%Y会被错误解析替换，导致DATE_FORMAT返回结果异常，分组逻辑失效。

两种可选解决方法：

• 把SQL中的单个百分号转义为两个百分号：

$sql = 'SELECT COUNT(pr.id) AS attendees, DATE_FORMAT(pr.joined_at, "%%m") AS month,
DATE_FORMAT(pr.joined_at, "%%Y") AS year FROM present pr GROUP BY month, year';
$attendance = DB::select($sql);

• 用DB::raw()包裹整个SQL，告知Laravel不需要处理参数绑定：

$attendance = DB::select(DB::raw($sql));

3. MySQL严格模式的影响 #

检查config/database.php中mysql配置项下的strict参数，如果为true，会开启MySQL的ONLY_FULL_GROUP_BY等严格校验规则，虽然你的SQL写法本身符合规则，也可以临时把该参数改为false测试结果是否正常。

4. 确认最终执行的SQL和结果 #

执行查询后调用dd(DB::getQueryLog())打印出Laravel最终发送到数据库执行的完整SQL，复制到控制台直接执行，就能确认是SQL被修改还是数据本身的问题。

Laravel的DB::select本身没有特殊的查询截断逻辑，它只是通过PDO将SQL发送到数据库执行并返回全量结果，不会默认做分页、过滤等操作。

内容的提问来源于stack exchange，提问作者Limitless Claver