Symfony 6中UserGroup多对多关联编辑无法持久化问题

尝试创建控制器方法编辑已有的UserGroup实体，仅修改其与User实体的ManyToMany关联字段（这是表单中的唯一字段）。尽管POST数据已发送，且调用handleRequest()后检查实体显示关联字段已正确获取，但数据始终无法保存。
注意：使用Symfony生成的CRUD控制器也无法保存该关联字段，其他字段可正常保存，推测是关联定义存在问题。

相关代码 #

UserGroup实体代码 #

#[ORM\Entity(repositoryClass: UserGroupRepository::class)]
class UserGroup extends ItemCollection implements IMessageInternalRecipient
{
    const USER_GROUP_MARKETING = 'marketing';

    #[ORM\ManyToMany(targetEntity: User::class, mappedBy: 'groups', cascade: ['persist', 'remove'])]
    private Collection $users;

    public function __construct()
    {
        $this->users = new ArrayCollection();
    } 

    /*
    insert into user_group(view_order, shortname, name) values(1, 'marketing', 'Equipo de marketing');
    */

    /**
     * @return Collection<int, User>
     */
    public function getUsers(): Collection
    {
        return $this->users;
    }

    public function addUser(User $user): static
    {
        if (!$this->users->contains($user)) {
            $this->users->add($user);
            $user->addGroup($this);
        }

        return $this;
    }

    public function removeUser(User $user): static
    {
        if ($this->users->removeElement($user)) {
            $user->removeGroup($this);
        }

        return $this;
    }
}

ItemCollection基类代码 #

#[ORM\MappedSuperclass]
class ItemCollection
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    protected $id;

    #[ORM\Column(type: 'string', length: 100)]
    protected $shortname;

    //... and other fields
}

User实体关联代码 #

#[ORM\ManyToMany(targetEntity: UserGroup::class, inversedBy: 'users')]
private Collection $groups;

UserGroupType表单代码 #

class UserGroupType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('users', EntityType::class, [
                                                'label'        => 'Marketing users',
                                                'class'        => User::class,
                                                'choice_label' => 'email',
                                                'multiple'     => true,
                                                'expanded'     => true
                                              ])
        ;
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => UserGroup::class,
        ]);
    }
}

控制器方法代码 #

#[Route('/group_users/{shortname}', name: 'app_user_group_users', methods: ['GET', 'POST'])]
public function groupUsers(Request $request,
                           EntityManagerInterface $entityManager,
                           UserGroupRepository $userGroupRepository,
                           LoggerInterface $logger,
                           string $shortname): Response
{
    $userGroup = $userGroupRepository->findOneBy(['shortname' => $shortname]);

    if ($userGroup == null)
        return $this->redirectToRoute('app_user_index', [], Response::HTTP_SEE_OTHER);
        
    $form = $this->createForm(UserGroupType::class, $userGroup, 
                             ['action' => $this->generateUrl('app_user_group_users', ['shortname' => $shortname])]);
    $form->handleRequest($request);

    if ($form->isSubmitted() && $form->isValid())
    {
        // $entityManager->persist($userGroup); //This was tried but didn't work either 
        $entityManager->flush();

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

    return $this->render('user/group_users.html.twig', [
                            'user_group' => $userGroup,
                            'form'       => $form,
                        ]);
}

核心原因 #

Doctrine的ManyToMany关联区分拥有端和反向端：

• User实体中的groups字段是关联的拥有端（通过inversedBy声明反向关联）
• UserGroup实体中的users字段是反向端（通过mappedBy指向拥有端）

Doctrine只会跟踪拥有端的关联变化来更新中间表，反向端的修改不会触发数据库更新，这就是数据无法保存的根本原因。

解决方案 #

方案1：切换关联的拥有端（推荐） #

将UserGroup设为关联的拥有端，调整关联定义：

1. 修改UserGroup实体的关联注解：

#[ORM\ManyToMany(targetEntity: User::class, inversedBy: 'groups', cascade: ['persist', 'remove'])]
#[ORM\JoinTable(name: 'user_user_group')] // 可选：指定中间表名称
private Collection $users;

2. 修改User实体的关联注解：

#[ORM\ManyToMany(targetEntity: UserGroup::class, mappedBy: 'users')]
private Collection $groups;

调整后UserGroup成为拥有端，Doctrine会直接跟踪其users集合的变化，提交表单后flush()即可正常更新中间表。

方案2：手动同步拥有端关联 #

若不想修改关联结构，可在表单提交后手动同步User实体的groups集合：
在控制器的提交验证块中添加：

if ($form->isSubmitted() && $form->isValid())
{
    // 同步新增的关联
    foreach ($userGroup->getUsers() as $user) {
        if (!$user->getGroups()->contains($userGroup)) {
            $user->addGroup($userGroup);
            $entityManager->persist($user);
        }
    }

    // 移除已取消的关联
    $allUsers = $entityManager->getRepository(User::class)->findAll();
    foreach ($allUsers as $user) {
        if ($user->getGroups()->contains($userGroup) && !$userGroup->getUsers()->contains($user)) {
            $user->removeGroup($userGroup);
            $entityManager->persist($user);
        }
    }

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

额外注意事项 #

• 确保User实体的addGroup和removeGroup方法正确实现：

public function addGroup(UserGroup $group): static
{
    if (!$this->groups->contains($group)) {
        $this->groups->add($group);
    }
    return $this;
}

public function removeGroup(UserGroup $group): static
{
    $this->groups->removeElement($group);
    return $this;
}

• 无需调用persist($userGroup)，通过findOneBy获取的实体已处于Doctrine管理状态，直接flush()即可。

内容的提问来源于stack exchange，提问作者K. Weber