Symfony表单验证与提交需按请求类型区分：HTML表单用handleRequest()自动绑定校验；JSON请求须手动解码后submit()并处理CSRF；文件上传需FileType配合move()；集合字段须设by_reference=false并加@Assert\Valid。
处理Symfony表单的验证与提交，需根据请求来源、HTTP方法和数据格式选择对应路径：HTML表单用handleRequest()自动绑定并校验，JSON请求需手动解码后submit()，PUT/PATCH须启用方法覆盖，文件上传依赖FileType及move()，集合字段必须配置by_reference=false与@Assert\Valid。
标准HTML表单提交与验证
这是最常见场景，适用于普通页面提交。
第一步：在控制器中创建表单实例，传入数据对象（如new User()）或空数组。
第二步：调用$form->handleRequest($request)，该方法会自动读取$_POST数据、绑定字段、执行CSRF校验，并标记是否已提交。
第三步：用if ($form->isSubmitted() && $form->isValid())判断——【isValid()必须在isSubmitted()为true后调用，否则永远返回false】。
第四步：验证通过后，$form->getData()返回填充好的对象，可直接持久化；失败时Twig模板中使用{{ form_errors(form) }}或{{ form_errors(form.email) }}渲染错误信息。
JSON请求的提交处理
前端发送Content-Type: application/json时，handleRequest()完全失效，必须手动解码并提交。
获取原始请求体：$json = $request->getContent()。
解码为关联数组：$data = json_decode($json, true)；若解码失败（如空内容或语法错误），需提前检查json_last_error()，否则submit()会静默失败。
跳过自动请求检测，直接提交：$form->submit($data)；此时不会触发CSRF校验，如需保留CSRF保护，应在JSON中显式携带_token字段并在表单类型中配置mapped=true、required=true。
文件上传的特殊处理
文件字段必须使用FileType，并确保HTML表单enctype="multipart/form-data"。
表单构建时添加字段：->add('avatar', FileType::class, ['mapped' => false, 'required' => true])；【mapped => false是强制要求，否则Doctrine会尝试把UploadedFile对象存入数据库】。
验证通过后，从$form->get('avatar')->getData()获取Symfony\Component\HttpFoundation\File\UploadedFile实例。
调用move($directory, $fileName)完成保存；该操作不可逆，若目标目录不存在或无写权限，会抛出FileException。
集合字段（CollectionType）的验证要点
方法一：启用嵌套验证
在实体属性上添加@Assert\Valid注解，确保子项也触发验证规则。
方法二：禁用引用传递
CollectionType配置中必须设置'by_reference' => false，否则子表单修改不会同步回父对象属性。
方法三：提供原型（prototype）
前端动态增删行时，Twig中需启用prototype：{{ form_widget(form.items.vars.prototype)|e('js') }}；否则新增行字段名无法匹配服务器端预期结构，导致submit()忽略该部分数据。
