TypeORM多对多关系保存时关联表project_tag出现重复行如何避免

1. 关联表的实体定义存在底层冲突 #

• 你在ProjectEntity中通过@ManyToMany + @JoinTable({ name: 'project_tag' })声明多对多关系时，TypeORM会默认全权接管project_tag关联表的写入逻辑，正常场景下这张关联表不需要手动定义映射实体，结构仅包含关联双方的外键列即可，且默认会将两个外键列设为联合主键。
• 但你又额外定义了ProjectTagEntity映射同一张project_tag表，还给表结构加了自增主键、创建时间字段，这就造成了两套完全独立的写入逻辑：TypeORM的自动关联维护逻辑完全感知不到你手动定义的实体存在，两边对表结构的认知（尤其是主键规则）都不一致，写入时不会做任何状态同步与重复校验，从架构层面埋下了重复写入的隐患。

2. TypeORM多对多关联的保存逻辑本身不自带幂等校验 #

• TypeORM的save方法处理多对多关联时，默认采用追加写入逻辑：只要检测到实体的关联数组被赋值，就会直接向关联表插入对应关联记录，不会自动对比实体当前已有的关联数据和待写入数据的差异。
• 加上你定义的tags是懒加载的Promise类型，如果保存前没有先加载项目原有的关联标签，TypeORM完全不知道项目之前已经和tag1、tag2存在绑定关系，只会按照你传入的标签列表执行插入，自然会生成重复记录。
• 另外你示例代码中存在字段笔误：实体定义的关联字段为tags，但赋值操作写的是project.categories，若运行时未做字段映射修正，该赋值本身不会触发关联写入，实际触发重复写入的是其他未加载原有关联就直接插入的场景。

3. 数据库层缺失兜底约束 #

• 你在ProjectTagEntity中仅将projectId、tagId设为非空列，没有给这两个字段加组合唯一约束，数据库本身完全允许同一个项目ID对应同一个标签ID生成多行记录，就算应用层逻辑漏判重复，数据库也无法拦截非法写入。

1. 统一关联表的管理逻辑，消除实体冲突 #

• 如果不需要在关联表上存储额外业务字段（比如创建时间、绑定来源），直接删除多余的ProjectTagEntity即可，完全交由TypeORM的原生多对多关联逻辑维护关联表结构，避免两套写入逻辑打架。
• 如果确实需要在关联表上存储自定义字段，需要彻底放弃ProjectEntity上的自动多对多关联写法，改成双向一对多关系：即ProjectEntity与ProjectTagEntity建立一对多关联，TagEntity与ProjectTagEntity建立一对多关联，所有关联关系的维护全部通过操作ProjectTagEntity实现，完全收回关联表的写入控制权。

2. 给关联表加物理唯一约束 #

• 无论采用哪种关联维护方案，都必须给project_tag表的projectId、tagId字段添加组合唯一索引。如果是手动维护关联实体的场景，直接在ProjectTagEntity类上添加@Unique(['projectId', 'tagId'])装饰器即可从数据库层面杜绝重复关联记录，就算应用层逻辑出错，数据库也会直接拒绝重复插入操作。

3. 修正保存逻辑做前置校验 #

• 如果采用TypeORM原生自动多对多关联的写法，保存关联时不要直接给tags数组覆盖赋值：
  • 保存前先通过await取出当前项目已绑定的所有标签，基于已有tagId列表过滤待写入的标签，仅追加不存在的标签；如果是全量覆盖关联的场景，需要先手动清空原有关联，再写入新的标签列表，最后调用save方法。
• 如果是手动维护关联实体的场景，写入前先查询当前项目与目标标签是否已经存在关联记录，存在则跳过插入逻辑，不存在再执行新增操作，配合数据库唯一约束做双重兜底。

内容的提问来源于stack exchange，提问作者Wildan Dicky Alnatara