TYPO3 9.5.5表单中如何用locallang.xlf翻译自定义验证错误消息？

问题分析 #

你遇到的情况是Form扩展里，表单字段的选项标签、前置提示都能正常通过locallang.xlf翻译，但自定义验证错误消息始终不生效。核心原因有两个：一是YAML配置存在语法错误，二是翻译ID的格式没有匹配Form扩展的规则。

步骤1：修复YAML配置的语法问题 #

你的customform.yaml里，validationErrorMessages部分有个明显的语法错误——同一个数组项里重复定义了code和message，这会导致后面的键覆盖前面的内容，系统根本无法正确识别多个错误消息。正确的写法是把每个错误消息拆成独立的数组项，同时把消息文本替换为LLL翻译引用：

renderables:
  - properties:
      fluidAdditionalAttributes:
        required: required
      validationErrorMessages:
        # 每个错误消息单独作为一个数组项
        - code: 1221560910
          message: 'LLL:EXT:你的扩展标识/Resources/Private/Language/locallang.xlf:element.subject.validationError.1221560910'
        - code: 1221560718
          message: 'LLL:EXT:你的扩展标识/Resources/Private/Language/locallang.xlf:element.subject.validationError.1221560718'
        - code: 1347992400
          message: 'LLL:EXT:你的扩展标识/Resources/Private/Language/locallang.xlf:element.subject.validationError.1347992400'
        - code: 1347992400
          message: 'LLL:EXT:你的扩展标识/Resources/Private/Language/locallang.xlf:element.subject.validationError.1347992400'
      options:
        products: 'Products'
        miscellaneous: 'Sonstiges'
      prependOptionLabel: 'Please Specify'
    type: SingleSelect
    identifier: subject
    label: 'Your Subject:'
    validators:
      - identifier: NotEmpty

步骤2：调整locallang.xlf的翻译ID规则 #

TYPO3 Form扩展对验证错误消息的翻译ID有特殊要求：必须关联对应的错误code值，因为每个错误消息都绑定唯一的代码。你之前用的element.subject.properties.validationErrorMessages.message太笼统，系统无法匹配到具体的错误项。修改后的locallang.xlf应该是这样：

<trans-unit id="element.subject.properties.prependOptionLabel">
  <source>Please Specify --Works!</source>
</trans-unit>
<trans-unit id="element.subject.properties.options.products">
  <source>Products --Works!</source>
</trans-unit>
<!-- 针对每个错误代码单独设置翻译项 -->
<trans-unit id="element.subject.validationError.1221560910">
  <source>Custom Message for required field - Works!</source>
</trans-unit>
<trans-unit id="element.subject.validationError.1221560718">
  <source>Custom Message for invalid input - Works!</source>
</trans-unit>
<trans-unit id="element.subject.validationError.1347992400">
  <source>Custom Message for format error - Works!</source>
</trans-unit>

步骤3：清除缓存并测试 #

完成上述修改后，一定要清除TYPO3的所有缓存（包括页面缓存、语言缓存和配置缓存），然后刷新前端页面测试表单的验证功能，此时错误消息应该能正确显示翻译后的内容了。

额外说明 #

如果你想全局替换某类错误代码的消息，也可以使用Form的默认翻译ID格式：validation.error.xxxxxx（把xxxxxx换成对应的错误代码），但这种方式会影响所有使用该错误代码的表单字段，而前面的字段专属ID更适合个性化的表单需求。

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