Laravel Eloquent多表关联问题：查询Petugas关联的Pelanggan

我来帮你排查一下问题，你遇到的无结果返回主要有几个关键原因，咱们一步步解决：

1. 目标Petugas不存在 #

你用了Petugas::find(3)，但看你的数据库数据，tbl_petugas里只有id=1和id=2的记录，这个查询会直接返回null，后续的关联调用自然不会有结果。先把查询条件改成存在的ID，比如find(1)。

2. 关联调用的逻辑错误 #

$petugas->segment返回的是集合（因为belongsToMany是多对多关联，一个Petugas对应多个Segment），不是单个Segment模型。你直接在集合上调用->kelompok是无效的，必须遍历每个Segment或者通过正确的关联链式调用获取数据。

3. 模型关联的配置细节错误 #

你的关联定义有几处不符合Eloquent的默认规则，导致无法正确识别关联关系：

• 类名大小写不匹配：比如Kelompokjalan::class应该是KelompokJalan::class（你的模型类是KelompokJalan，类名大小写必须一致）。
• 非默认外键未明确指定：对于自定义命名的外键和中间表，需要明确告诉Eloquent对应的字段，否则会用默认规则（比如默认找pelanggan_id，但你的中间表里是pelanggan_nometer）。

修正后的模型关联配置 #

先把各个模型的关联定义修正：

Petugas模型 #

class Petugas extends Model {
    // 改名成更清晰的方法名，明确关联的是KelompokJalan集合
    public function kelompokJalans() {
        return $this->belongsToMany(
            KelompokJalan::class,
            'tbl_segment',       // 中间表名
            'petugas_id',        // 当前模型在中间表的外键
            'kelompok_jalan_id'  // 关联模型在中间表的外键
        );
    }
}

KelompokJalan模型 #

class KelompokJalan extends Model {
    // 改名明确是多个Pelanggan
    public function pelanggans() {
        return $this->belongsToMany(
            Pelanggan::class,
            'tbl_kelompok_jalan_pelanggan', // 中间表名
            'kelompok_jalan_id',            // 当前模型在中间表的外键
            'pelanggan_nometer'             // 关联模型在中间表的外键（对应Pelanggan的主键nometer）
        );
    }

    public function petugas() {
        return $this->belongsToMany(
            Petugas::class,
            'tbl_segment',
            'kelompok_jalan_id',
            'petugas_id'
        );
    }
}

正确获取关联Pelanggan的方式 #

方式1：预加载+集合合并（直观易理解） #

这种方式适合理清关联链，同时避免N+1查询问题：

// 预加载所有层级的关联，提升查询效率
$petugas = Petugas::with('kelompokJalans.pelanggans')->find(1);

// 合并所有KelompokJalan下的Pelanggan集合
$allPelanggan = $petugas->kelompokJalans->flatMap(function ($kelompokJalan) {
    return $kelompokJalan->pelanggans;
});

return $allPelanggan;

方式2：直接定义Petugas到Pelanggan的快捷关联（简化调用） #

如果需要经常从Petugas直接获取Pelanggan，可以在Petugas模型里添加嵌套关联：

class Petugas extends Model {
    // 原有关联
    public function kelompokJalans() {
        return $this->belongsToMany(KelompokJalan::class, 'tbl_segment', 'petugas_id', 'kelompok_jalan_id');
    }

    // 新增：直接关联Pelanggan的快捷方式
    public function pelanggans() {
        return $this->belongsToMany(
            Pelanggan::class,
            'tbl_segment',       // 第一个中间表
            'petugas_id',        // Petugas在tbl_segment的外键
            'kelompok_jalan_id'  // KelompokJalan在tbl_segment的外键
        )
        ->join(
            'tbl_kelompok_jalan_pelanggan', 
            'tbl_segment.kelompok_jalan_id', 
            '=', 'tbl_kelompok_jalan_pelanggan.kelompok_jalan_id'
        )
        ->select('pelanggan.*'); // 只选择Pelanggan的字段，避免重复字段冲突
    }
}

调用时就非常简洁：

$petugas = Petugas::with('pelanggans')->find(1);
return $petugas->pelanggans;

内容的提问来源于stack exchange，提问作者Riko Pramayudi