事务（Transactions）是数据库保证数据一致性的核心机制，支持“原子性、一致性、隔离性、持久性（ACID）”；并发控制则解决多用户同时操作数据时的冲突问题，TypeORM 提供了完善的事务管理和并发控制方案，适配不同业务场景的需求。

一、事务基础概念

1. 事务的核心特性（ACID）

• 原子性（Atomicity）：事务中的所有操作要么全部执行，要么全部回滚；
• 一致性（Consistency）：事务执行前后，数据库数据始终保持合法状态；
• 隔离性（Isolation）：多个事务并发执行时，互相不可见（隔离级别可配置）；
• 持久性（Durability）：事务提交后，修改永久保存到数据库。

一、实体基础定义

实体（Entity）是 TypeORM 中映射数据库表的核心载体，本质是被装饰器标记的 TypeScript 类，每个实体实例对应数据库表中的一行数据，实体类的属性对应表的字段。

1. 基础实体定义（@Entity 装饰器）

import { Entity, Column, PrimaryGeneratedColumn } from "typeorm";

// 基础定义：默认表名为类名小写（如当前类名 User → 表名 user）
@Entity()
export class User {
  // 自增主键（TypeORM 自动适配数据库自增策略）
  @PrimaryGeneratedColumn()
  id: number;

  // 普通字符串字段（默认映射为 varchar(255)）
  @Column()
  username: string;

  // 带自定义配置的字段
  @Column({
    length: 100,      // 字段长度
    nullable: false,   // 非空约束（默认值为 false）
    default: "未知用户", // 默认值
    comment: "用户昵称"  // 数据库字段注释
  })
  nickname: string;

  @Column({ type: "int", default: 0 })
  age: number;
}

一、Repository 模式（推荐）

Repository（仓库）是 TypeORM 针对单个实体的操作封装，每个实体对应一个 Repository，提供标准化的 CRUD 方法，是最常用的数据操作方式。

1. 获取 Repository

import { AppDataSource } from "./data-source";
import { User } from "./entity/User";

// 方式1：从数据源直接获取
const userRepository = AppDataSource.getRepository(User);

// 方式2：NestJS 中通过依赖注入（推荐）
import { Injectable } from "@nestjs/common";
import { InjectRepository } from "@nestjs/typeorm";
import { Repository } from "typeorm";

@Injectable()
export class UserService {
  constructor(
    @InjectRepository(User)
    private readonly userRepository: Repository<User>,
  ) {}
}

QueryBuilder 是 TypeORM 中最灵活的查询工具，支持链式调用构建复杂 SQL，兼顾可读性和灵活性，是原生 SQL 的“类型安全替代方案”，尤其适合多表联查、复杂条件筛选、聚合统计等场景。

一、QueryBuilder 基础用法

1. 初始化 QueryBuilder

QueryBuilder 可从 Repository/EntityManager 初始化，核心方法为 createQueryBuilder：

import { User } from "./entity/User";
import { AppDataSource } from "./data-source";

const userRepository = AppDataSource.getRepository(User);

// 方式1：从 Repository 初始化（推荐，自动关联实体）
const queryBuilder = userRepository.createQueryBuilder("u"); 
// "u" 是实体别名，后续查询中通过别名引用字段

// 方式2：从 EntityManager 初始化（跨实体场景）
const queryBuilder = AppDataSource.manager.createQueryBuilder(User, "u");

// 方式3：直接构建原生 SQL 查询（无实体关联）
const rawQueryBuilder = AppDataSource.createQueryBuilder().select("*").from("sys_user", "u");

实体关系是 TypeORM 映射数据库表间关联的核心能力，对应数据库的外键关系，支持一对一、一对多/多对一、多对多三种核心关系，同时提供级联操作、懒加载/急加载等扩展能力。

一、关系基础概念

1. 关系方向

• 单向关系：仅一方实体声明关联（如 User → Profile，仅 User 知道 Profile 存在）；
• 双向关系：双方实体都声明关联（如 User ↔ Profile，互相知道对方存在），便于从任意一方查询关联数据。

数据库迁移（Migrations）是 TypeORM 中管理数据库表结构变更的核心方案，替代了 synchronize: true（仅适合开发环境），能够精准控制表结构的创建、修改、删除，保证开发、测试、生产环境的表结构一致，同时支持回滚操作，避免手动改表导致的环境不一致问题。

一、迁移的核心作用

1. 环境一致性：所有表结构变更通过迁移文件管理，团队成员/不同环境执行相同迁移，保证表结构一致；
2. 可追溯性：每一个迁移文件对应一次表结构变更，可清晰追溯变更历史；
3. 可回滚性：支持回滚到任意历史版本，解决变更出错的问题；
4. 生产安全：替代 synchronize: true（生产禁用），避免自动同步导致的表结构意外变更。

索引和约束是数据库性能优化和数据完整性保障的核心，TypeORM 提供了装饰器和迁移两种方式配置索引/约束，既支持开发环境快速配置，也支持生产环境通过迁移精准管控。

一、约束（Constraints）

约束用于保证数据库数据的完整性和一致性，TypeORM 支持主键、非空、唯一、外键、默认值等核心约束，可通过实体装饰器或迁移配置。

1. 主键约束（Primary Key）

主键是表的唯一标识，每张表只能有一个主键，支持单字段主键和复合主键：

（1）单字段主键（常用）

import { Entity, PrimaryGeneratedColumn, Column } from "typeorm";

@Entity()
export class User {
  // 自增主键（MySQL: AUTO_INCREMENT，PostgreSQL: serial）
  @PrimaryGeneratedColumn()
  id: number;

  // 手动指定主键（非自增，需手动赋值）
  // @PrimaryColumn({ type: "uuid" })
  // id: string;
}

监听者（Listeners）和订阅者（Subscribers）是 TypeORM 实现“实体生命周期事件驱动”的核心能力，监听者聚焦单个实体的专属逻辑，订阅者实现跨实体的通用逻辑，可用于数据校验、自动填充、日志审计、业务触发等场景，替代传统的“硬编码”业务逻辑，提升代码复用性和可维护性。

一、监听者（Listeners）

监听者是实体级别的生命周期钩子，直接绑定到单个实体类中，通过装饰器标记，在实体的增删改查等操作前后执行自定义逻辑，是实现单个实体专属业务逻辑的首选方式。

1. 核心生命周期钩子

MongoDB 是免费开源的跨平台 NoSQL 数据库，命名源于英文单词 humongous，意思是「巨大无比」，可见开发组对 MongoDB 的定位。与关系型数据库不同，MongoDB 的数据以类似于 JSON 格式的二进制文档存储：

{
  "name": "McConaughey",
  "age": 18,
  "hobbies": ["travel", "swimming"]
}

MongoDB逻辑结构 💎

MongoDB 与 MySQL 中的架构相差不多，底层都使用了可插拔的存储引擎以满足用户的不同需要。用户可以根据程序的数据特征选择不同的存储引擎，在最新版本的 MongoDB 中使用了 WiredTiger 作为默认的存储引擎，WiredTiger 提供了不同粒度的并发控制和压缩机制，能够为不同种类的应用提供了最好的性能和存储率。