当前位置：首页 > news >正文

TypeORM 入门教程：@ManyToOne 与 @OneToMany 关系详解

news 2025/9/9 8:26:32

在 TypeORM 中，@ManyToOne 和 @OneToMany 是用于定义实体间"多对一"和"一对多"关系的核心装饰器。这两种关系通常成对使用，共同构建完整的关联模型。

核心概念解析

@ManyToOne（多对一）

定义：表示当前实体属于另一个实体的"多"方，即多个当前实体实例关联到同一个父实体实例
关键特性：
- 必须指定关联的目标实体类型
- 自动在数据库中创建外键列（默认名为目标实体名+Id）
- 是关系中的"拥有方"，负责维护外键关系

@OneToMany（一对多）

定义：表示当前实体包含多个关联实体的"一"方
关键特性：
- 必须与@ManyToOne成对使用
- 不会自动创建数据库列，仅表示逻辑关系
- 通过mappedBy属性指向关联的@ManyToOne属性

基础使用示例

1. 用户-照片关系（经典一对多）

// User.ts
import { Entity, PrimaryGeneratedColumn, Column, OneToMany } from "typeorm";
import { Photo } from "./Photo";@Entity()
export class User {@PrimaryGeneratedColumn()id: number;@Column()name: string;@OneToMany(() => Photo, photo => photo.user)  // 指定关联类型和反向引用photos: Photo[];
}// Photo.ts
import { Entity, PrimaryGeneratedColumn, Column, ManyToOne } from "typeorm";
import { User } from "./User";@Entity()
export class Photo {@PrimaryGeneratedColumn()id: number;@Column()url: string;@ManyToOne(() => User, user => user.photos)  // 指定关联类型和反向引用user: User;
}

2. 博客系统（文章-评论关系）

// Post.ts
@Entity()
export class Post {@PrimaryGeneratedColumn()id: number;@Column()title: string;@OneToMany(() => Comment, comment => comment.post)comments: Comment[];
}// Comment.ts
@Entity()
export class Comment {@PrimaryGeneratedColumn()id: number;@Column()content: string;@ManyToOne(() => Post, post => post.comments)post: Post;
}

高级配置选项

自定义外键名称

@ManyToOne(() => User, user => user.photos, {onDelete: "CASCADE"  // 可选：设置级联删除
})
@JoinColumn({ name: "custom_user_id" })  // 自定义外键列名
user: User;

级联操作

@OneToMany(() => Photo, photo => photo.user, {cascade: ["insert", "update"]  // 自动级联插入/更新
})
photos: Photo[];

延迟加载控制

@ManyToOne(() => User, user => user.photos, {eager: true  // 立即加载关联实体
})
user: User;

常见问题解决方案

1. 查询时加载关联数据

// 查询用户及其所有照片
const user = await userRepository.findOne({where: { id: 1 },relations: ["photos"]
});// 或使用QueryBuilder
const userWithPhotos = await userRepository.createQueryBuilder("user").leftJoinAndSelect("user.photos", "photo").where("user.id = :id", { id: 1 }).getOne();

2. 处理循环引用

当实体间存在双向关系时，序列化时可能出现循环引用问题：

// 使用class-transformer的@Exclude和@Expose
import { Exclude, Expose } from "class-transformer";@Entity()
export class User {// ...其他字段@OneToMany(() => Photo, photo => photo.user)@Exclude()  // 排除序列化photos: Photo[];@Expose()get photoCount() {  // 自定义序列化属性return this.photos?.length || 0;}
}

3. 性能优化建议

选择性加载：只查询需要的关联数据
分页处理：对一对多关系进行分页
索引优化：为外键列添加索引
批量操作：使用QueryRunner进行批量插入/更新

最佳实践

始终成对使用：@ManyToOne和@OneToMany应同时定义（除非有特殊需求）
明确关系方向：确定哪个实体是关系的"拥有方"
合理使用级联：避免过度使用级联操作导致数据意外修改
考虑查询模式：根据实际查询需求设计关系结构
文档化关系：在实体类中添加注释说明关系含义

完整示例：订单系统

// Order.ts
@Entity()
export class Order {@PrimaryGeneratedColumn()id: number;@Column()total: number;@OneToMany(() => OrderItem, item => item.order, {cascade: true,eager: true})items: OrderItem[];
}// OrderItem.ts
@Entity()
export class OrderItem {@PrimaryGeneratedColumn()id: number;@Column()productName: string;@Column()quantity: number;@ManyToOne(() => Order, order => order.items)order: Order;
}// 使用示例
async function createOrder() {const order = new Order();order.total = 100;order.items = [{ productName: "Product A", quantity: 2 },{ productName: "Product B", quantity: 1 }];await getRepository(Order).save(order);  // 自动保存关联项
}