Symfony 5 EntityType/ChoiceType编辑多对多关联时数据被意外覆盖问题

业务规则与已实现逻辑 #

• 实体基础关联关系
  • Child实体与User、Service实体分别建立ManyToMany关联
  • User实体通过ManyToOne关联自身所属的Service
• 业务约束要求：不同服务的管理员编辑Child信息时，仅能选择当前管理员所属Service下的User为Child分配关联，跨服务的历史关联必须保留，不能被编辑操作清除
• 已落地的表单配置
  • 在ChildType表单类中，为users字段配置EntityType类型
  • 通过query_builder参数限定查询范围，仅加载当前登录管理员所属Service下的User
  • 配置multiple=true、expanded=true实现多选复选框渲染
  • 仅对拥有ROLE_ADMIN权限的用户展示服务分配模块

异常表现 #

• 触发场景：某Child预先关联了服务1下的多个用户，使用服务2的管理员账号登录编辑该Child，为其新增关联2个服务2下的用户
• 实际结果：数据库可正常新增Child与服务2用户的关联记录，但Child与服务1下原有用户的多对多关联被全部自动删除，完全不符合跨服务关联需保留的预期
• 排查进展：已连续排查2小时暂未定位根因，已整理ChildType表单类、控制器edit方法、User/Service/Child实体关联定义的相关代码，用于问题定位

问题根因 #

这是Symfony多对多表单字段的经典踩坑点，完全是表单处理机制和查询逻辑不匹配导致的：

1. 只要是配了multiple=true的EntityType字段，表单提交时根本不会比对原有关联和提交值的差异，直接用提交的选中项整个替换实体上对应的多对多集合
2. 在query_builder里只查询当前管理员所属服务的用户时，表单渲染阶段根本不会把Child之前关联的其他服务的用户列成可选选项，提交时这部分跨服务的老关联因为不在可选列表里，自然就被表单判定为「用户未选中」，直接从关联集合中移除
3. 最后Doctrine执行flush操作时，会按照处理后的关联集合同步中间表数据，那些不在提交值范围内的跨服务老关联自然就被全部清除了

可落地的解决方案 #

• 最易维护的方案：调整query_builder的查询逻辑，同时加载两类User：
  • 当前登录管理员所属Service下的全部User：作为可自由勾选的新增关联项
  • 当前Child实体上已经关联的、不属于当前管理员所属Service的User：作为已选中的只读项渲染
    实现时给这部分跨服务已关联的选项加disabled属性，避免用户误取消选择导致关联丢失
• 低侵入实现思路：绕开表单自动覆盖关联集合的逻辑，在控制器执行完$form->submit()、表单校验通过后，手动将被表单逻辑清除的跨服务关联重新加回Child的$users集合中，再触发Doctrine持久化
• 注意事项：使用低侵入方案时，需确认Child与User多对多关联的持有端（owning side）配置在Child实体上，否则会出现关联无法正常写入中间表的问题

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