如何查询包含关联标签的Content对象（TypeORM）

问题原因 #

你当前的QueryBuilder写法只是手动关联了交叉表和标签表，但没有将查询到的标签映射到Content实体的tags属性上，TypeORM无法自动填充该字段；另外如果实体的关联配置不正确，也会导致关联数据无法被正确加载。

解决方案 #

根据你的交叉表是否包含额外字段，分两种情况处理：

情况1：交叉表仅存关联ID（无额外字段） #

这种情况直接用TypeORM的@ManyToMany关联即可，无需手动处理交叉表：

1. 正确配置实体

Content 实体：

import { Entity, PrimaryGeneratedColumn, Column, ManyToMany, JoinTable } from "typeorm";
import { Tag } from "./Tag";

@Entity('contents')
export class Content {
    @PrimaryGeneratedColumn()
    id: number;

    @Column()
    title: string;

    @ManyToMany(() => Tag, tag => tag.contents)
    @JoinTable({
        name: 'content_tags_xref', // 指定你的交叉表名
        joinColumn: { name: 'content_id', referencedColumnName: 'id' },
        inverseJoinColumn: { name: 'tag_id', referencedColumnName: 'id' }
    })
    tags: Tag[];
}

Tag 实体：

import { Entity, PrimaryGeneratedColumn, Column, ManyToMany } from "typeorm";
import { Content } from "./Content";

@Entity('tags')
export class Tag {
    @PrimaryGeneratedColumn()
    id: number;

    @Column()
    title: string;

    @ManyToMany(() => Content, content => content.tags)
    contents: Content[];
}

2. 简化查询

可以直接用findOne指定关联关系：

findContent(content_id: number): Promise<Content> {
    return this.contentRepository.findOne({
        where: { id: content_id },
        relations: ['tags']
    });
}

如果坚持用QueryBuilder，写法如下：

findContent(content_id: number): Promise<Content> {
    return this.contentRepository.createQueryBuilder('content')
        .leftJoinAndSelect('content.tags', 'tag') // 直接关联实体的tags属性
        .where('content.id = :content_id', { content_id })
        .getOne();
}

情况2：交叉表包含额外字段（如创建时间、排序值等） #

此时需要将交叉表作为独立实体，用@OneToMany和@ManyToOne关联：

1. 配置实体

ContentTagXref 交叉表实体：

import { Entity, PrimaryGeneratedColumn, Column, ManyToOne } from "typeorm";
import { Content } from "./Content";
import { Tag } from "./Tag";

@Entity('content_tags_xref')
export class ContentTagXref {
    @PrimaryGeneratedColumn()
    id: number;

    @Column()
    content_id: number;

    @Column()
    tag_id: number;

    // 示例额外字段
    @Column()
    created_at: Date;

    @ManyToOne(() => Content, content => content.tagRefs)
    content: Content;

    @ManyToOne(() => Tag, tag => tag.contentRefs)
    tag: Tag;
}

Content 实体修改：

@Entity('contents')
export class Content {
    // ... 原有字段

    @OneToMany(() => ContentTagXref, ref => ref.content)
    tagRefs: ContentTagXref[];
}

Tag 实体修改：

@Entity('tags')
export class Tag {
    // ... 原有字段

    @OneToMany(() => ContentTagXref, ref => ref.tag)
    contentRefs: ContentTagXref[];
}

2. 查询并手动组装结果

async findContent(content_id: number): Promise<any> {
    const content = await this.contentRepository.createQueryBuilder('content')
        .leftJoinAndSelect('content.tagRefs', 'ctx')
        .leftJoinAndSelect('ctx.tag', 'tag')
        .where('content.id = :content_id', { content_id })
        .getOne();

    // 手动提取标签，组装成你需要的结构
    return {
        id: content.id,
        title: content.title,
        tags: content.tagRefs.map(ref => ref.tag)
    };
}

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