TYPO3 v10.4.21安装自定义Flipbox插件后点击列表报错如何解决

错误根因 #

你混淆了**自定义内容元素（CType模式）和前端插件（list_type模式）**的配置逻辑，同时存在命名不统一、冗余配置的问题，系统误把你的内容元素识别为需要关联独立数据库表的插件，才触发了表不存在的报错，按以下步骤修复即可：

1. 修正配置逻辑冲突 #

你开发的是不需要额外独立表的自定义内容元素，完全不需要用到插件相关的配置，首先做以下清理：

• 先纠正文件名错误：你写的ext_location.php是无效文件名，正确的扩展配置文件名是ext_localconf.php，先把文件名改对。
• 删掉ext_localconf.php里的两段PageTSConfig插件向导配置，你已经走CType模式不需要这部分配置。
• 修改Configuration/TCA/Overrides/tt_content.php里的addPlugin方法调用，保证注册的CType和后续配置一致：

\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addPlugin(
   [
       'My Flipbox',
       'flipbox_contentelement', // 必须和你下方TCA定义的types键名完全一致
       'EXT:core/Resources/Public/Icons/T3Icons/content/content-carousel-image.svg'
   ],
   'CType',
   'myextensionkey'
);

• 在同一个tt_content.php文件末尾添加自定义内容元素的后台向导配置：

\TYPO3\CMS\Core\Utility\ExtensionManagementUtility::addPageTSConfig('
mod.wizards.newContentElement.wizardItems.common.elements.flipbox_contentelement {
    iconIdentifier = content-carousel-image
    title = My Flipbox
    description = 翻转框自定义内容元素
    tt_content_defValues {
        CType = flipbox_contentelement
    }
}
mod.wizards.newContentElement.wizardItems.common.show := addToList(flipbox_contentelement)
');

2. 清理冗余的Domain Model配置 #

报错提示查找的表名和你代码里写的扩展键名不一致，说明你之前尝试创建过插件对应的Domain Model，还残留了相关配置：

• 删掉扩展目录下Domain/Model/NewFlipbox.php文件
• 删掉Configuration/TCA/tx_myextensionkey_domain_model_newflipbox.php文件（如果存在）
• 删掉Configuration/Extbase/Persistence/Classes.php里和NewFlipbox模型相关的配置（如果存在）
• 如果你确实需要用独立表存储额外字段，就在扩展根目录新建ext_tables.sql写入表结构，再到后台安装工具执行数据库比较更新即可，否则不需要做这一步。

3. 校验TypoScript配置 #

你现有的TypoScript配置是正确的，只要确保站点根模板已经引入了该扩展的TypoScript，模板文件EXT:myextensionkey/Resources/Private/Templates/NewContentElement.html存在即可正常渲染。

验证生效 #

全部修改完成后清理TYPO3全站缓存，重新添加内容元素即可正常使用。

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