TYPO3 V11.5纯后端扩展访问后端报错是BUG还是缺少配置？

该问题不属于TYPO3本身的BUG，是部署过程中的配置遗漏导致的。

问题场景前提 #

• 运行环境为TYPO3 v11.5版本
• 部署的扩展仅包含后端功能模块，无前端插件逻辑
• 扩展未配置configPlugin参数
• 扩展根目录无ext_localconfig文件
• 扩展Configuration/TCA/Overrides路径下不存在tt_content.php配置文件

报错根因 #

未在站点模板的包含配置中引入该扩展自带的TypoScript模板，导致扩展运行所需的后端配置参数未被TYPO3系统加载，触发报错。

修复步骤 #

1. 登录TYPO3后端，进入左侧「站点」模块，选中对应站点的根页，点击页面顶部的「模板」菜单
2. 切换到「编辑整个模板记录」视图，选择Includes选项卡
3. 在「可用的包含项」列表中找到对应扩展的模板条目，点击添加到右侧「已选的包含项」列表
4. 保存模板配置后，清空TYPO3系统全部缓存，重新访问扩展后端模块即可恢复正常

补充说明 #

部分纯后端扩展会将模块权限、后端视图渲染路径、功能参数等配置写在自带的TypoScript模板文件中，即便没有前端插件相关配置，也需要手动引入模板才能让扩展正常运行。

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