Typo3 11.5配置wv_deepltranslate提示未找到系统语言如何解决

问题现象 #

• 基于TYPO3 11.5搭建多语言站点，通过wv_deepltranslate扩展对接DeepL实现内容元素批量翻译
• 手动创建的翻译页面可在前端正常渲染，但扩展运行异常：设置页提示No system languages found.；已正确配置DeepL API Key与API地址，创建翻译条目时可正常显示翻译按钮，但点击按钮仅复制原语言内容元素，无法触发自动翻译流程

原有配置问题梳理 #

Typoscript配置（错误版本） #

config.sys_language_uid = 0
config.language = de
config.locale_all = de_DE

[globalVar = GP:L = 1]
config.sys_language_uid = 0
config.language = en
config.locale_all = en_EN
[global]

[globalVar = GP:L = 0]
config.sys_language_uid = 0
config.language = de
config.locale_all = de_DE
[global]

存在2处错误：

• 英文语言（L=1）条件分支内，sys_language_uid错误赋值为0，与默认德语的语言ID重合，会导致后端语言识别逻辑混乱
• 英文分支内locale_all配置为无效值en_EN，不符合系统区域设置规范

站点配置（错误版本） #

languages:
  -
    title: Deutsch
    enabled: true
    base: /
    typo3Language: de
    locale: de_DE
    iso-639-1: de
    navigationTitle: Deutsch
    hreflang: de-DE
    direction: ''
    flag: de
    languageId: 0
    websiteTitle: ''
  -
    title: English
    enabled: false
    base: /en/
    typo3Language: default
    locale: en_US.UTF-8
    iso-639-1: en
    websiteTitle: ''
    navigationTitle: English
    hreflang: en
    direction: ''
    fallbackType: strict
    fallbacks: ''
    flag: en-us-gb
    languageId: 1

存在2处错误：

• 英文语言项enabled属性设为false，系统和第三方扩展无法识别该目标语言为可用状态
• 英文语言项typo3Language属性错误赋值为default，应匹配语言标识设为en

核心报错解决方法 #

*No system languages found.*报错的直接触发原因：未在站点页面根节点的列表菜单中创建对应语言的系统语言记录。
修复操作流程：

• 进入TYPO3后端页面模块，选中站点根节点页面
• 切换到根节点的列表视图，找到系统语言记录创建入口
• 为站点配置的所有语言（含默认语言、目标翻译语言）创建对应的系统语言记录，准确关联对应语言ID、语言参数
• 修正上述Typoscript、站点YAML配置中的错误项，保存后清空TYPO3全量系统缓存
• 返回wv_deepltranslate设置页验证，报错消失后即可正常触发DeepL自动批量翻译

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