TYPO3 Extbase proper关联识别错误致LMS课程筛选查询失效

当前TCA配置的关联方向完全不符合Extbase的1:N关联识别规则。你目前的配置实际是「父表存储子表uid逗号分隔串」的反向M:N关系，Extbase会生成基于FIND_IN_SET的LEFT JOIN逻辑——因为你的业务逻辑本身是子表通过template字段关联父表uid，父表的template_children字段从来不写入值，自然永远匹配不到有效关联，查不出结果。

之前尝试切换inline但没生效，核心是缺了foreign_field的声明，Extbase不知道关联是通过子表的外键字段维护，还是会按老逻辑走逗号串匹配。

1. 修正TCA关联配置 #

删掉现有template_children字段配置里的冗余参数，补全1:N关联的核心声明，让Extbase明确关联关系存在于子表的外键上，完全不需要父表字段存储内容：

'template_children' => [
    'exclude' => true,
    'label' => 'LLL:EXT:xxx/Resources/Private/Language/locallang_db.xlf:tx_xxx_domain_model_courseprogrammetemplate.template_children',
    'config' => [
        'type' => 'inline',
        'foreign_table' => 'tx_xxx_domain_model_courseprogrammetemplate',
        // 核心缺失配置：声明子表上存储父表uid的外键字段
        'foreign_field' => 'template',
        'foreign_table_where' => 'AND tx_xxx_domain_model_courseprogrammetemplate.sys_language_uid = 0',
        'readOnly' => 1,
        'size' => 5,
        'autoSizeMax' => 20,
    ],
],

配置生效后，Extbase不会再尝试读取父表上template_children字段的存值，也不会生成FIND_IN_SET的关联逻辑。

2. 校验领域模型映射 #

确保CourseProgrammeTemplate模型中templateChildren的属性定义正确匹配关联类型，保证查询解析器能正确识别关联路径：

/**
 * 关联的子课程集合
 * @var \TYPO3\CMS\Extbase\Persistence\ObjectStorage<\XXX\Xxx\Domain\Model\CourseProgrammeTemplate>
 * @Lazy
 */
protected $templateChildren;

3. 优化查询逻辑避免性能问题 #

原查询即使配置修正后，直接关联子表字段做过滤也会出现笛卡尔积重复结果（一个研讨会匹配N个符合条件的子课程，就会返回N条重复的父记录），可以通过拆分子查询的方式规避N+1和重复数据问题：

// 先单独查询符合日期条件的子课程，收集其关联的父研讨会uid
$subQuery = $this->courseRepository->createQuery();
$matchedChildren = $subQuery->matching(
    $subQuery->greaterThanOrEqual('start_date', $demand->getStartDate()->format('Y-m-d H:i:s'))
)->execute()->toArray();

$validSeminarUids = array_unique(array_map(
    fn($child) => $child->getTemplate()->getUid(),
    $matchedChildren
));

// 主查询约束调整为
$constraints[] = $query->logicalAnd([
    $query->logicalOr([
        // 独立课程模板的过滤逻辑保持不变
        $query->logicalAnd([
            $query->greaterThanOrEqual('start_date', $demand->getStartDate()->format('Y-m-d H:i:s')),
            $query->logicalNot($query->equals('learning_form', 'Seminar'))
        ]),
        // 研讨会过滤：直接匹配父表主键集合，不需要关联JOIN
        $query->logicalAnd([
            $query->in('uid', $validSeminarUids),
            $query->equals('learning_form', 'Seminar')
        ])
    ])
]);

这种方式只需要执行两次数据库查询，一次拿符合条件的子课程，一次走主键索引匹配父表，性能远高于关联JOIN和逐记录查询。

• 不要再使用selectSingleBox类型的配置做1:N关联，这类配置天生基于「父表存逗号串uid」的逻辑，永远会生成FIND_IN_SET的低效SQL
• 配置了foreign_field后，父表的关联字段完全不需要写入任何数据，所有关联关系只靠子表的外键字段维护
• TYPO3 11LTS以上版本可以直接用exists子查询语法实现相同过滤逻辑，但大表场景下还是建议用uid集合IN匹配的方式，走主键索引性能更优

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