如何使用TypeORM更新实体的多个ManyToMany关联关系？

问题背景 #

我有一个包含多个ManyToMany关联的Candidate实体，尝试用TypeORM的update方法实现更新时，出现错误：Error: Cannot query across many-to-many for property tools。

实体定义 #

Candidate实体：

@Entity()
export class Candidate {
    @PrimaryGeneratedColumn()
        id: number;
    
    // 其他字段...

    @ManyToMany(() => Language, { nullable: true })
    @JoinTable()
        languages: Language[];

    @ManyToMany(() => Tool, { nullable: true })
    @JoinTable()
        tools: Tool[];

    @ManyToMany(() => ActivityArea, { nullable: true })
    @JoinTable()
        activity_areas: ActivityArea[];

    // 其他字段...

    @Column({ nullable: true })
        desired_starting_date: string;

    // 其他字段...
}

Language实体（其他关联实体结构类似）：

@Entity()
export class Language {
    @PrimaryGeneratedColumn()
        id: number;

    @Column({unique: true})
        name: string;
}

错误的实现代码 #

async update(id: number, updateCandidateDto: UpdateCandidateDto) {
    try {
        const candidate = this.generateaCandidate(updateCandidateDto); // 生成候选者新值

        return await this.candidateRepository.update({
            id
        }, {
            languages: candidate.languages,
            tools: candidate.tools,
            activity_areas: candidate.activity_areas,
            desired_starting_date: candidate.desired_starting_date
        });
    } catch (error) {
        throw new HttpException(error.detail, HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

问题原因 #

TypeORM的update方法是直接生成SQL的批量更新操作，无法处理多对多关联的中间表数据变更，直接传递关联数组会触发跨关联查询的错误。正确方式是先获取实体实例，修改关联后再执行保存操作。

正确的更新实现 #

async update(id: number, updateCandidateDto: UpdateCandidateDto) {
    try {
        // 1. 查询目标Candidate实体，同时加载所有关联关系
        const existingCandidate = await this.candidateRepository.findOne({
            where: { id },
            relations: ['languages', 'tools', 'activity_areas']
        });

        if (!existingCandidate) {
            throw new HttpException('候选者不存在', HttpStatus.NOT_FOUND);
        }

        // 2. 更新普通字段
        existingCandidate.desired_starting_date = updateCandidateDto.desired_starting_date;
        // 其他普通字段按此方式同步更新...

        // 3. 处理多对多关联：替换为新的关联数据
        // 注：这里假设DTO中关联字段传的是ID数组，需先查询对应实体
        if (updateCandidateDto.languages) {
            const languages = await this.languageRepository.findByIds(updateCandidateDto.languages);
            existingCandidate.languages = languages;
        }

        if (updateCandidateDto.tools) {
            const tools = await this.toolRepository.findByIds(updateCandidateDto.tools);
            existingCandidate.tools = tools;
        }

        if (updateCandidateDto.activity_areas) {
            const activityAreas = await this.activityAreaRepository.findByIds(updateCandidateDto.activity_areas);
            existingCandidate.activity_areas = activityAreas;
        }

        // 4. 保存实体，TypeORM自动处理中间表的关联增删
        return await this.candidateRepository.save(existingCandidate);
    } catch (error) {
        throw new HttpException(error.detail || '更新失败', HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

补充说明 #

• 如果UpdateCandidateDto中的关联字段已经是实体对象而非ID数组，可省略查询实体的步骤，直接赋值即可。
• 使用save方法时，TypeORM会自动对比实体关联的变化，自动更新中间表数据（删除旧关联、添加新关联）。
• 若不需要保留旧关联，直接赋值新的关联数组即可，无需手动清理旧数据。

内容的提问来源于stack exchange，提问作者Timothée CLEAR