TYPO3中RequiredArgumentMissingException问题：单选表单为何无法传值？

问题场景 #

我有两个TYPO3表单，第一个可正常工作，代码如下：

<f:form action="rate" controller="GameRate" arguments="{gameRate: gameRate}">
   <f:form.select name="rating" options="{1: '1', 2: '2', 3: '3', 4: '4', 5: '5'}" />
   <f:form.submit value="Bewerten" />
</f:form>

但第二个表单提交时出现错误，代码如下：

<f:form action="rate" controller="GameRate" arguments="{gameRate: gameRate}">
    <input type="radio" id="stern5" name="rating" value=5><label for="stern5"></label>
    <input type="radio" id="stern4" name="rating" value=4><label for="stern4"></label>
    <input type="radio" id="stern3" name="rating" value=3><label for="stern3"></label>
    <input type="radio" id="stern2" name="rating" value=2><label for="stern2"></label>
    <input type="radio" id="stern1" name="rating" value=1><label for="stern1"></label>
    <f:form.submit value="Bewerten" />
</f:form>

提交第二个表单时的错误信息：

(1/1) #1298012500 TYPO3\CMS\Extbase\Mvc\Controller\Exception\RequiredArgumentMissingException
Required argument "rating" is not set for Bennet\Grkey\Controller\GameRateController->rate.

问题原因 #

TYPO3的Extbase框架会自动为<f:form>包裹的表单字段添加命名空间前缀（格式通常为tx_扩展标识_插件标识[字段名]）。第一个表单使用了<f:form.select>官方ViewHelper，它会自动处理命名空间，所以rating参数能被Extbase正确识别并传递到控制器。

而第二个表单用了原生<input>标签，直接写name="rating"，没有加上Extbase要求的命名空间前缀，导致控制器无法识别这个参数，从而抛出「必填参数缺失」的错误。

解决方案 #

方式一：使用TYPO3官方ViewHelper #

用<f:form.radio>替换原生input，它会自动添加正确的命名空间，代码示例：

<f:form action="rate" controller="GameRate" arguments="{gameRate: gameRate}">
    <f:form.radio id="stern5" name="rating" value="5" /><label for="stern5"></label>
    <f:form.radio id="stern4" name="rating" value="4" /><label for="stern4"></label>
    <f:form.radio id="stern3" name="rating" value="3" /><label for="stern3"></label>
    <f:form.radio id="stern2" name="rating" value="2" /><label for="stern2"></label>
    <f:form.radio id="stern1" name="rating" value="1" /><label for="stern1"></label>
    <f:form.submit value="Bewerten" />
</f:form>

方式二：手动添加命名空间前缀 #

查看第一个表单渲染后的HTML源码，找到<select>标签的name属性值（比如类似tx_grkey_gamerate[rating]），然后将原生radio的name改成这个值，示例：

<f:form action="rate" controller="GameRate" arguments="{gameRate: gameRate}">
    <input type="radio" id="stern5" name="tx_grkey_gamerate[rating]" value="5"><label for="stern5"></label>
    <input type="radio" id="stern4" name="tx_grkey_gamerate[rating]" value="4"><label for="stern4"></label>
    <input type="radio" id="stern3" name="tx_grkey_gamerate[rating]" value="3"><label for="stern3"></label>
    <input type="radio" id="stern2" name="tx_grkey_gamerate[rating]" value="2"><label for="stern2"></label>
    <input type="radio" id="stern1" name="tx_grkey_gamerate[rating]" value="1"><label for="stern1"></label>
    <f:form.submit value="Bewerten" />
</f:form>

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