PAYATHON 2026

Symfony UX Live Components 文件验证为何要等其他字段通过后才触发?

数据小陈

结论

Symfony UX Live Components 默认没有要求先通过 title 验证才能验证 image。要在同一次提交中显示两个字段的错误,需要把普通字段值和实际上传的文件一起传给 Symfony Form。

题目中的 files|saveTourDetails 会发送待上传文件,还要检查这些文件是否合并到了 submitForm() 使用的数据中。现有代码不足以确定错误延后出现的全部原因。

为什么会出现这种现象?

文件上传和表单字段同步走的是不同的数据通道:

  • files modifier 将文件发送到服务器,可以通过 $request->files 读取。普通组件更新请求默认不会发送文件。参见官方文件上传文档。
  • 在所核对的 ComponentWithFormTrait 实现中,submitForm() 调用 $form->submit($this->formValues),不会自动读取 $request->files。表单无效时,该方法会抛出 UnprocessableEntityHttpException,中断 Action 的后续执行。参见ComponentWithFormTrait 源码。

服务器收到文件后,仍需将其传入表单,文件才会参与表单验证。如果读取文件或单独验证文件的代码放在 submitForm() 后面,前面的表单验证失败时,这些代码就不会执行。

File 约束允许 null 和空字符串。文件没有进入表单时,maxSize、mimeTypes 不会因此产生错误;如果要求必须上传文件,需要另加 NotBlank 等约束。参见File 约束文档。

在 submitForm() 前合并上传文件

如果组件使用 ComponentWithFormTrait,且项目安装版本的提交逻辑与上述源码一致,可以在现有 Action 中先合并文件,再提交表单:

use Symfony\Component\HttpFoundation\Request;
use Symfony\UX\LiveComponent\Attribute\LiveAction;

#[LiveAction]
public function saveTourDetails(Request $request): void
{
    $form = $this->getForm();
    $formName = $form->getName();

    $uploadedFiles = $formName === ''
        ? $request->files->all()
        : $request->files->all($formName);

    $this->formValues = array_replace_recursive(
        $this->formValues,
        $uploadedFiles
    );

    $this->submitForm();

    // Only persist data or move files after successful validation.
    $image = $this->getForm()->get('image')->getData();
}

在已有组件类中加入这段代码,保留原来的 instantiateForm() 和 FormType 配置。示例针对题目中的单文件字段;复杂集合或多文件字段需要根据实际数据结构检查合并结果。

取文件时要使用表单名称。例如,输入名称是 tour[image] 时,文件位于 $request->files->all('tour')['image'];$formValues 中的字段键则应是 image,不能直接合并包含 tour 的整层数组。

按钮可以保持原样:

<button type="button" data-action="live#action" data-live-action-param="files|saveTourDetails">
Save
</button>

合并后,title 和 image 会在同一次 Form 提交中接受验证。如果没有额外验证分组或自定义逻辑的限制,title 的 NotBlank 错误不会阻止无效文件产生自己的验证错误。

确保模板显示文件字段错误

如果使用默认表单主题,form_row() 会渲染字段及其错误:

{{ form_start(form) }}
    {{ form_row(form.title) }}
    {{ form_row(form.image) }}

    <button type="button"
            data-action="live#action"
            data-live-action-param="files|saveTourDetails">
        Save
    </button>
{{ form_end(form) }}

如果模板用 form_widget(form.image) 自行布局,还需要渲染 form_errors(form.image)。字段即使已经验证,如果错误没有被渲染,看起来也像是没有触发验证。参见Symfony 表单文档。

修改后如何检查?

先将 title 留空,再选择一个小于 2M 但 MIME 类型不是 image/jpeg 的文件,点击 Save。检查这次请求是否携带文件,以及提交前 $formValues['image'] 是否为 UploadedFile,以区分上传问题和约束验证问题。

如果文件已经进入表单但仍没有错误,再检查自定义 validation_groups、GroupSequence、表单事件监听器和错误渲染逻辑。题目没有提供这些配置,不能据此认定是某个版本的缺陷。

上述方式在点击 Save 后,通过同一次请求验证所有字段。如果要在选择文件后立即验证,需要额外触发携带文件的 LiveAction。后续普通组件更新不能假定会重新携带该文件;再次提交前应确认文件仍会上传。如果需要跨请求保留文件,则应设计临时存储流程。

备注:内容仅供参考。