TypeORM多对多关联中间表写入时异常更新而非新增关联行的问题

这是TypeORM多对多关联保存时的典型状态覆盖问题，核心错误点有三个：

1. 非持久化实体的关联操作触发全量关联替换 #

方法里传入的categor是仅携带基础字段的实体实例，并没有通过分类Repository从数据库加载、获取它持久化状态下的关联快照。当你手动给这个实例的products数组赋值、仅push新生成的产品后，调用categor.save()时，TypeORM会判定当前这个分类的产品关联需要被你提供的数组全量替换——也就是原来和这个分类绑定的所有旧产品关联都会被移除，替换成你当前塞进去的新产品。
最终表现就是中间表里原有的categoryId=1的行，关联的productId从旧的24更新为新产品的id，完全不会新增预期的关联行。

2. 手动双向维护关联状态导致重复触发变更 #

产品实体标注了@JoinTable，是这个多对多关联的持有方，只需要在产品侧维护关联关系，TypeORM就会自动处理中间表的写入，根本不需要手动给分类侧的products数组push实体、再保存分类。这种双重维护关联的写法，很容易因为状态不同步出现覆盖问题。

3. 保存顺序错误放大了状态覆盖的影响 #

先保存新产品拿到自增id，再保存分类时，ORM已经识别到你给分类的products数组里的实体有合法id，会直接按照关联变更逻辑替换旧的关联记录，不会走新增关联的分支。

多对多关联的操作可以大幅简化，完全不需要手动维护双向数组：

1. 直接构造新产品的基础字段，通过Repository创建产品实例
2. 只需要把已存在分类的实体实例（哪怕仅携带主键id）赋值给新产品的categories属性即可
3. 直接保存产品，TypeORM会自动在中间表新增对应关联行

async addProduct(productDetails: productsEntity, username, categoryId: number){
    const {title, description, price, units}  = productDetails;
    try{ 
        // 构造新产品实例，填入基础字段
        const newProduct = this.productsRepository.create({
            title,
            description,
            price,
            units,
            soldBy: username,
        });

        // 关联已存在的分类，仅需要传入分类的主键即可，不需要加载分类的现有关联
        const existCategory = this.categoryRepository.create({ id: categoryId });
        newProduct.categories = [existCategory];

        // 直接保存产品，TypeORM会自动在中间表插入新的关联记录
        await this.productsRepository.save(newProduct);
    }
    catch(err){
        this.logger.error(err.message);
        throw new HttpException('Failed adding Product.', HttpStatus.INTERNAL_SERVER_ERROR)
    }
}

• 只有标注了@JoinTable的实体侧需要维护多对多关联，另一侧的关联属性仅做查询用，不需要手动修改、保存
• 不要对没有从Repository查询得到的分离态实体，直接修改关联属性后调用save，这类实体没有加载数据库现有数据的快照，保存时会直接用当前提供的属性值覆盖现有数据
• 给产品侧的多对多关联配置了eager: true后，保存产品后查询产品时会自动带出关联的分类列表，不需要额外维护分类侧的反向关联

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