TYPO3 Doctrine QueryBuilder左连接报错：别名‘c’不唯一求助

错误原因 #

报错提示别名c不唯一，是因为当前$queryBuilder实例中已经有其他表占用了这个别名（从报错信息的已注册别名列表可确认），Doctrine QueryBuilder不允许在同一个查询中重复使用表别名。

修正步骤及完整代码 #

1. 更换重复别名：将分类表的别名从c改为cat，并同步修改所有引用该别名的代码位置
2. 补全过滤条件：还原旧代码中遗漏的hidden/deleted状态过滤逻辑，保证查询结果与原逻辑一致
3. 适配结果获取：Doctrine QueryBuilder执行后需调用fetchAllAssociative()，才能得到与exec_SELECTgetRows()一致的关联数组结果

修正后的代码如下：

// 定义查询约束条件，补全旧代码中的所有过滤规则
$catConstraints = [
    // 产品状态过滤：未隐藏、未删除
    $queryBuilder->expr()->eq('p.hidden', $queryBuilder->createNamedParameter(0, \PDO::PARAM_INT)),
    $queryBuilder->expr()->eq('p.deleted', $queryBuilder->createNamedParameter(0, \PDO::PARAM_INT)),
    // 分类状态过滤：未隐藏、未删除
    $queryBuilder->expr()->eq('cat.hidden', $queryBuilder->createNamedParameter(0, \PDO::PARAM_INT)),
    $queryBuilder->expr()->eq('cat.deleted', $queryBuilder->createNamedParameter(0, \PDO::PARAM_INT)),
    // 分类名称非空
    $queryBuilder->expr()->neq('cat.name', $queryBuilder->createNamedParameter('')),
    // 匹配指定material
    $queryBuilder->expr()->eq('p.material', $queryBuilder->createNamedParameter($materialUid, \PDO::PARAM_INT))
];

$categories = $queryBuilder
    ->select('cat.uid', 'cat.id', 'cat.name AS categoryName', 'cat.tstamp')
    ->from($productsTable, 'p')
    ->leftJoin(
        'p',
        $categoriesTable,
        'cat', // 使用新别名避免冲突
        $queryBuilder->expr()->eq(
            'p.category',
            $queryBuilder->quoteIdentifier('cat.uid')
        )
    )
    ->where(...$catConstraints)
    ->groupBy('p.category')
    ->executeQuery()
    ->fetchAllAssociative(); // 转换为关联数组，与原exec_SELECTgetRows返回格式一致

额外优化建议（可选） #

在TYPO3中，推荐使用内置的Restriction机制自动处理hidden/deleted过滤，替代手动写条件，更符合框架最佳实践：

// 添加TYPO3默认的删除、隐藏限制
$queryBuilder->getRestrictions()
    ->add(\TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\Query\Restriction\DeletedRestriction::class))
    ->add(\TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\Query\Restriction\HiddenRestriction::class));

// 此时约束条件可简化为：
$catConstraints = [
    $queryBuilder->expr()->neq('cat.name', $queryBuilder->createNamedParameter('')),
    $queryBuilder->expr()->eq('p.material', $queryBuilder->createNamedParameter($materialUid, \PDO::PARAM_INT))
];

内容的提问来源于stack exchange，提问作者Jacco van der Post