Symfony 6.0.2：自动保存文件（无需提交按钮）及密码字段错误排查

核心问题 #

1. 表单字段重复定义：UserType中重复添加了两次password字段（先添加PasswordType，再添加RepeatedType），导致字段配置混乱，前一个定义被完全覆盖。
2. 必填校验与空值冲突：RepeatedType的required设为true，但密码输入框被隐藏（d-none），提交时无输入内容，Symfony会传递null而非你设置的empty_data，触发"期望string，实际传入null"的类型错误。
3. 场景不匹配：当前是头像上传场景，不需要修改密码，但表单仍保留了密码字段的必填校验逻辑。

解决方案 #

方案1：动态控制密码字段的必填性（保留字段但不强制校验） #

修改UserType.php

移除重复的PasswordType字段定义，将必填性改为可配置参数：

<?php

namespace App\Form;

use App\Entity\User;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;
use Symfony\Component\Form\Extension\Core\Type\FileType;
use Symfony\Component\Form\Extension\Core\Type\SubmitType;
use Symfony\Component\Form\Extension\Core\Type\PasswordType;
use Symfony\Component\Form\Extension\Core\Type\RepeatedType;

class UserType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('password', RepeatedType::class, [
                'type' => PasswordType::class,
                'invalid_message' => 'Les deux mots de passe doivent être identiques.',
                'options' => ['attr' => ['class' => 'password-field']],
                'required' => $options['require_password'],
                'first_options'  => ['label' => 'Password'],
                'second_options' => ['label' => 'Repeat Password'],
                'empty_data' => '',
                'mapped' => false, // 头像上传场景无需映射密码到User实体
            ])
            ->add('photo', FileType::class, [
                'mapped' => false,
            ])
            ->add('save', SubmitType::class, [
                'attr' => ['class' => 'save'],
            ])
        ;
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => User::class,
            'translation_domain' => 'forms',
            'require_password' => true, // 默认场景需要密码
        ]);
    }
}

修改SecurityController.php的addPhoto方法

创建表单时传入require_password => false，禁用密码字段的必填校验：

$userform = $this->createForm(UserType::class, $user, [
    'require_password' => false,
]);

方案2：直接移除密码字段（更适合头像上传场景） #

如果头像上传完全不需要涉及密码，直接在控制器中移除表单的密码字段：

// SecurityController.php 的 addPhoto 方法
$userform = $this->createForm(UserType::class, $user);
$userform->remove('password'); // 移除密码字段，彻底避免校验问题

同时简化edit.html.twig，去掉密码输入框的渲染：

{{ form_start(form)  }}
    {{ form_widget(form.photo, {'attr' : {'onChange' : 'this.form.submit();'}} ) }}
    {{ form_widget(form.save, {'attr' : {'class' : 'd-none'}}) }}
{{ form_end(form) }}

为什么之前的empty_data不生效？ #

重复定义的password字段导致第一个配置被覆盖，且RepeatedType的required: true会优先校验字段是否存在有效值，空输入会被Symfony判定为缺失，传递null而非你设置的空字符串。

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