TYPO3 Extension Builder整合现有表问题：数据未被读取

我之前也碰到过类似的坑，咱们一步步来排查，把每个可能的配置点都过一遍：

1. 先确认模型的基础配置是否正确 #

你的Event模型必须放在正确的路径下，命名空间也得对应上：

• 文件路径：EXT:institutsseminarverwaltung/Classes/Domain/Model/Event.php
• 命名空间要严格匹配扩展结构：

namespace YourVendor\Institutsseminarverwaltung\Domain\Model;

use TYPO3\CMS\Extbase\DomainObject\AbstractEntity;

class Event extends AbstractEntity {
    // 你的属性和getter/setter方法
}

记得把YourVendor换成你实际的供应商名称（比如你的个人前缀或公司名），扩展键institutsseminarverwaltung要和表名里的前缀完全一致。

2. 验证属性与数据库列的映射关系 #

如果现有表的列名不是Extbase默认的「驼峰转下划线」规则（比如模型$startDate对应数据库start_date），必须显式指定列名：
在模型属性上添加@ORM\Column注解：

use Doctrine\ORM\Mapping as ORM;

class Event extends AbstractEntity {
    /**
     * @var string
     * @ORM\Column(name="event_title", type="string")
     */
    protected $eventTitle;

    // 对应的getter和setter
    public function getEventTitle(): string {
        return $this->eventTitle;
    }

    public function setEventTitle(string $eventTitle): void {
        $this->eventTitle = $eventTitle;
    }
}

如果有大量非标准列名，也可以在ext_typoscript_setup.txt里配置全局映射：

config.tx_extbase.persistence.classes {
    YourVendor\Institutsseminarverwaltung\Domain\Model\Event {
        mapping {
            tableName = tx_institutsseminarverwaltung_domain_model_event
            columns {
                event_title.mapOnProperty = eventTitle
                # 其他列的映射规则依次添加
            }
        }
    }
}

3. 检查Repository的创建与注入 #

要读取数据必须有对应的仓库类：

• 文件路径：EXT:institutsseminarverwaltung/Classes/Domain/Repository/EventRepository.php
• 仓库类代码：

namespace YourVendor\Institutsseminarverwaltung\Domain\Repository;

use TYPO3\CMS\Extbase\Persistence\Repository;

class EventRepository extends Repository {}

然后在控制器里注入这个仓库才能调用：

namespace YourVendor\Institutsseminarverwaltung\Controller;

use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
use YourVendor\Institutsseminarverwaltung\Domain\Repository\EventRepository;

class EventController extends ActionController {
    /**
     * @var EventRepository
     */
    protected $eventRepository;

    /**
     * @param EventRepository $eventRepository
     */
    public function injectEventRepository(EventRepository $eventRepository): void {
        $this->eventRepository = $eventRepository;
    }

    public function listAction() {
        $events = $this->eventRepository->findAll();
        $this->view->assign('events', $events);
    }
}

4. 确认TCA配置是否到位 #

如果现有表没有对应的TCA配置，Extbase可能无法正确识别它。你可以在Configuration/TCA/Overrides/tx_institutsseminarverwaltung_domain_model_event.php里添加基础配置：

defined('TYPO3') or die();

\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::allowTableOnStandardPages(
    'tx_institutsseminarverwaltung_domain_model_event'
);

$GLOBALS['TCA']['tx_institutsseminarverwaltung_domain_model_event'] = [
    'ctrl' => [
        'title' => 'LLL:EXT:institutsseminarverwaltung/Resources/Private/Language/locallang_db.xlf:tx_institutsseminarverwaltung_domain_model_event',
        'label' => 'event_title', // 替换为你的表的显示字段
        'tstamp' => 'tstamp',
        'crdate' => 'crdate',
        'delete' => 'deleted',
        'enablecolumns' => [
            'disabled' => 'hidden',
        ],
        'searchFields' => 'event_title,description', // 替换为你的搜索字段
        'iconfile' => 'EXT:institutsseminarverwaltung/Resources/Public/Icons/tx_institutsseminarverwaltung_domain_model_event.svg'
    ],
    'columns' => [
        'hidden' => [
            'exclude' => true,
            'label' => 'LLL:EXT:core/Resources/Private/Language/locallang_general.xlf:LGL.hidden',
            'config' => [
                'type' => 'check',
                'renderType' => 'checkboxToggle',
            ],
        ],
        'event_title' => [
            'exclude' => true,
            'label' => 'LLL:EXT:institutsseminarverwaltung/Resources/Private/Language/locallang_db.xlf:tx_institutsseminarverwaltung_domain_model_event.event_title',
            'config' => [
                'type' => 'input',
                'size' => 30,
                'eval' => 'trim',
            ],
        ],
        // 其他列的配置按需添加
    ],
    'types' => [
        '1' => ['showitem' => 'hidden, event_title, description'], // 替换为你的字段
    ],
];

5. 一定要清理TYPO3缓存！ #

Extbase会缓存模型映射和配置，修改后必须清空全部缓存：

• 后台「维护」模块里点击「清空全部缓存」
• 或者用命令行：

vendor/bin/typo3 cache:flush

6. 临时调试排查 #

如果以上步骤都没问题，你可以在控制器里加一段调试代码，看看是不是启用字段过滤导致的：

public function listAction() {
    $query = $this->eventRepository->createQuery();
    $query->getQuerySettings()->setIgnoreEnableFields(true); // 临时忽略隐藏/禁用字段
    $events = $query->execute();
    var_dump($events->toArray()); // 直接打印数据，看是否有返回
}

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