Laravel中M_Obat::all()返回空数组但DB查询正常问题咨询

问题现象 #

• 调用Eloquent模型全量查询时返回空数组：

$data = M_Obat::all();

• 调用DB门面直接查询表时可正常返回2条数据结果：

$data = DB::table('master.ruangan')->get();

产生原因 #

该问题由Eloquent模型默认逻辑与实际业务表配置不匹配导致，核心原因分为三类：

• 表名映射错误：DB门面直接查询的是带master schema的ruangan表，但M_Obat模型未手动指定表名时，会按照类名自动拼接复数表名，默认查询m_obats表，完全未命中目标数据表
• 全局作用域过滤：若模型引入了软删除、多租户等全局作用域，查询时会自动追加WHERE过滤条件，而DB门面查询不会触发模型层的作用域逻辑，会直接查询全表数据
• 连接/主键配置错误：若master属于独立数据库连接，模型未指定对应连接时会走默认数据库连接；若表主键不符合Eloquent默认的自增id规则，也会导致查询结果异常

对应解决方案 #

1. 修正模型表与连接配置
   打开M_Obat模型文件，显式指定对应表名、数据库连接，确保和DB查询的目标配置一致：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class M_Obat extends Model
{
    // 显式指定绑定的表，包含schema前缀
    protected $table = 'master.ruangan';

    // 若master schema属于独立数据库连接，取消注释并填写对应连接名
    // protected $connection = 'master_connection';

    // 若表未使用软删除，移除模型内的SoftDeletes trait引用
}

2. 排查全局作用域拦截
   可通过查询监听打印Eloquent实际执行的SQL，和DB门面的查询SQL做对比，确认是否存在多余的过滤条件：

// 临时开启SQL监听
DB::listen(function($query) {
    dump($query->sql, $query->bindings);
});
$data = M_Obat::all();

若SQL中存在非预期的WHERE条件（如deleted_at is null、多租户字段过滤等），移除对应模型上不需要的全局作用域即可。

3. 修正主键配置
   如果目标表主键不是默认的自增id字段，需要在模型内显式声明主键配置，避免隐式查询逻辑异常：

// 指定实际主键字段名
protected $primaryKey = 'obat_id';
// 主键非自增时关闭自增标识
public $incrementing = false;
// 主键类型非整数时指定类型
protected $keyType = 'string';

内容的提问来源于stack exchange，提问作者Muchammad Adam