CakePHP 4多LEFT JOIN问题：非主表关联左连接的SQL生成异常

你的问题在于默认的contain()方法采用的是Eager Loading（预加载）策略，会先查询主表关联的Members数据，再单独查询Batches数据，所以生成了两条SQL。要生成和目标SQL一致的单条多LEFT JOIN语句，你需要使用leftJoinWith()或者手动构建join()来将Batches直接关联到主查询中，而非依赖contain的预加载方式。

方案一：使用leftJoinWith()（推荐，符合CakePHP ORM风格） #

leftJoinWith()会把关联表直接LEFT JOIN到主查询里，同时可以链式添加条件和字段选择，完全贴合你的需求：

$this->Visits->find()
    ->select([
        'Visits.member_id',
        'Members.mbr_name',
        'Visits.created',
        'Batches.grade_id'
    ])
    ->leftJoinWith('Members', function (Query $q) {
        return $q->select(['mbr_name', 'mbrid']);
    })
    ->leftJoinWith('Members.Batches', function (Query $q) {
        return $q->select(['grade_id', 'member_id'])
            ->where([
                'Batches.batch' => '2020',
                'Batches.sub_batch IN' => ['0', '1'] // 等价于原SQL的OR条件
            ]);
    })
    ->order(['Visits.created' => 'DESC']);

方案二：手动构建join（完全自定义，精准匹配目标SQL） #

如果你需要1:1复刻目标SQL的结构，可以直接用join()方法手动定义所有关联关系：

$this->Visits->find()
    ->select([
        'visits.member_id',
        'members.mbr_name',
        'visits.created',
        'batches.grade_id'
    ])
    ->join([
        'table' => 'members',
        'alias' => 'members',
        'type' => 'LEFT',
        'conditions' => 'members.mbrid = visits.member_id'
    ])
    ->join([
        'table' => 'batches',
        'alias' => 'batches',
        'type' => 'LEFT',
        'conditions' => 'batches.member_id = members.mbrid'
    ])
    ->where([
        'batches.batch' => '2020',
        'batches.sub_batch IN' => ['0', '1']
    ])
    ->order(['visits.created' => 'DESC']);

原代码问题说明 #

你原来两次调用contain()的写法，会触发CakePHP ORM的预加载机制：先查询Visits与Members的关联数据，再根据查询到的Members.mbrid批量查询Batches，这就是生成两条SQL的核心原因。而我们需要的是把所有关联合并到同一条SQL的LEFT JOIN中，因此必须用leftJoinWith()或手动join的方式实现。

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