TYPO3扩展升级12报错：Call to a member function getClassSchema() on null

可能的原因及对应修复方案 #

1. 实体类未正确注册为Doctrine实体 #

TYPO3 12对Doctrine实体的注册要求更严格，若控制器关联的实体类配置不规范，会导致ClassMetadataFactory返回null，触发该错误。

• 检查实体类是否添加了#[ORM\Entity]属性注解（TYPO3 12已弃用旧版注释式注解）
• 在ext_localconf.php中注册实体命名空间：

  $GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['your_extension_key']['doctrine']['mapping'][] = [
      'type' => 'attribute',
      'namespace' => 'Vendor\\YourExtension\\Domain\\Model',
      'path' => 'Classes/Domain/Model',
  ];
  

• 执行命令更新Doctrine元数据并清缓存：

  vendor/bin/typo3 doctrine:schema:update --dump-sql
  vendor/bin/typo3 cache:flush
  

2. 实体仓库的依赖注入配置有误 #

若控制器注入的仓库未正确关联实体类，会导致仓库初始化失败，进而引发错误。

• 检查Services.yaml中仓库的配置，确保实体类路径正确：

  Vendor\YourExtension\Domain\Repository\YourRepository:
    public: true
    arguments:
      $entityClassName: 'Vendor\YourExtension\Domain\Model\YourModel'
  

• 确认仓库类正确继承\TYPO3\CMS\Extbase\Persistence\Repository。

3. 缓存未彻底清除 #

残留的核心缓存或Doctrine元数据缓存可能导致类信息异常。

• 执行强制清缓存命令并手动删除缓存文件：

  vendor/bin/typo3 cache:flush --force
  rm -rf var/cache/*
  rm -rf var/transient/*
  

• 若开启了OPcache，重启PHP-FPM或Web服务器，确保旧类元数据被完全清除。

4. 控制器动作中实体实例化不规范 #

若直接手动实例化实体类而非通过仓库或ObjectManager，可能导致元数据未加载。

• 改用ObjectManager初始化实体：

  $entity = $this->objectManager->get(Vendor\YourExtension\Domain\Model\YourModel::class);
  

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