Symfony表单渲染报错：'app_config'字段已被渲染的解决方法

问题情况 #

Symfony表单渲染时抛出异常，提示字段"app_config"已被渲染，两天前功能正常，无明显诱因。

报错信息 #

An exception has been thrown during the rendering of a template ("Field "app_config" has already been rendered, save the result of previous render call to a variable and output that instead.")

相关代码 #

视图代码（Twig） #

{{ form_start(form) }}
    {{ form_widget(form) }}
    <button class="btn btn-outline-success">{{ button_label|default('app.save'|trans) }}</button>
{{ form_end(form) }}

控制器代码（PHP） #

$appConfig = new AppConfig();
$form = $this->createForm(AppConfigType::class, $appConfig);
$form->handleRequest($request);

if ($form->isSubmitted() && $form->isValid()) {
    $appConfigRepository->add($appConfig, true);

    return $this->redirectToRoute('backend_settings_index', [], Response::HTTP_SEE_OTHER);
}

return $this->renderForm('backend/crud/backend_settings/new.html.twig', [
    'app_config' => $appConfig,
    'form' => $form,
]);

错误来源代码（FormRenderer.php） #

/**
 * {@inheritdoc}
 */
public function searchAndRenderBlock(FormView $view, string $blockNameSuffix, array $variables = []): string
{
    $renderOnlyOnce = 'row' === $blockNameSuffix || 'widget' === $blockNameSuffix;

    if ($renderOnlyOnce && $view->isRendered()) {
        // This is not allowed, because it would result in rendering same IDs multiple times, which is not valid.
        throw new BadMethodCallException(sprintf('Field "%s" has already been rendered, save the result of previous render call to a variable and output that instead.', $view->vars['name']));
    }

解决步骤 #

1. 排查模板重复渲染

   • 检查当前模板及继承的父模板，是否在{{ form_widget(form) }}之外，又单独调用了{{ form_widget(form.app_config) }}或类似代码渲染该字段。
   • 确认是否误将控制器传递的app_config实体变量当成表单视图渲染，比如误写{{ form_widget(app_config) }}。

2. 检查表单类型配置

   • 查看AppConfigType最近的变更，是否新增了重复的字段定义，或者字段配置导致渲染逻辑冲突。

3. 验证form_end的行为

   • form_end(form)默认会自动渲染所有未被渲染的字段，如果form_widget(form)已经渲染了全部字段，可尝试显式关闭自动渲染：{{ form_end(form, {'render_rest': false}) }}，排查是否有隐藏字段重复渲染。

4. 回溯代码变更

   • 对比两天前的代码版本，重点查看模板、表单类型、控制器中与表单渲染相关的改动，定位触发问题的新增逻辑。

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