dbfirst 的 leftjoin on的操作
在 TypeORM 的 Database First (DB First) 模式下，处理 LEFT JOIN 的 ON 条件主要依赖于实体关系映射（Entity Relationship Mapping）。由于 DB First 模式通常通过工具（如 typeorm-model-generator）根据数据库外键自动生成实体代码，因此 ON 条件的构建方式与 Code First 略有不同，核心在于正确配置 @JoinColumn 和关系装饰器。
以下是针对 DB First 模式下 LEFT JOIN ON 操作的详细解析和最佳实践：
1. 核心原理：TypeORM 如何生成 ON 条件
在 TypeORM 中，你不需要手动编写 SQL 的 ON a.id = b.a_id。TypeORM 会根据实体类中的关系装饰器自动推导 ON 子句。
- 自动推导逻辑：
- 如果使用了
@ManyToOne或@OneToOne，TypeORM 会查找关联字段（通常由@JoinColumn指定）。 - 生成的 SQL 类似于：
LEFT JOIN table_b b ON b.foreign_key = a.primary_key。
- 如果使用了
2. DB First 模式下的关键配置
在 DB First 模式中，确保 LEFT JOIN 能正确生成 ON 条件的关键在于实体类中的 @JoinColumn 配置。
场景示例
假设数据库中有两张表：
users(主键id)orders(主键id, 外键user_id关联users.id)
生成的实体代码如下：
// User Entity
@Entity('users')
export class User {
@PrimaryGeneratedColumn()
id: number;
@Column()
name: string;
// 一对多关系：一个用户有多个订单
@OneToMany(() => Order, order => order.user)
orders: Order[];
}
// Order Entity
@Entity('orders')
export class Order {
@PrimaryGeneratedColumn()
id: number;
@Column()
orderNo: string;
// 多对一关系：多个订单属于一个用户
@ManyToOne(() => User, user => user.orders)
@JoinColumn({ name: 'user_id' }) // 【关键】明确指定数据库中的外键列名
user: User;
}
注意：在 DB First 生成的代码中，务必检查 @JoinColumn({ name: '...' }) 中的 name 是否与数据库实际的外键字段名完全一致。如果不一致，TypeORM 将无法生成正确的 ON 条件，导致查询错误或性能下降。
3. 使用 QueryBuilder 执行 LEFT JOIN
一旦实体关系配置正确，使用 QueryBuilder 进行 LEFT JOIN 非常简单。TypeORM 会自动处理 ON 部分。
基础用法：自动处理 ON 条件
const usersWithOrders = await userRepository
.createQueryBuilder('user')
.leftJoinAndSelect('user.orders', 'order') // TypeORM 自动生成 ON order.user_id = user.id
.getMany();
生成的 SQL：
SELECT ... FROM users user
LEFT JOIN orders order ON order.user_id = user.id
进阶用法：在 ON 中添加额外过滤条件
如果你需要在连接时就过滤右表数据（例如：只连接“已支付”的订单），可以使用 leftJoinAndSelect 的第三个参数。这对应 SQL 中的 ON ... AND ...。
const usersWithPaidOrders = await userRepository
.createQueryBuilder('user')
.leftJoinAndSelect(
'user.orders',
'order',
'order.status = :status', // 额外的 ON 条件
{ status: 'PAID' }
)
.getMany();
生成的 SQL：
SELECT ... FROM users user
LEFT JOIN orders order ON order.user_id = user.id AND order.status = 'PAID'
重要区别：
- 写在 ON 中：即使没有“已支付”的订单，用户记录依然会返回（订单字段为
NULL）。 - 写在 WHERE 中：如果没有“已支付”的订单，用户记录会被直接过滤掉（等效于 INNER JOIN）。
4. 常见陷阱与解决方案
陷阱 1：外键字段名不匹配
在 DB First 模式中，如果数据库外键名为 usr_id，但实体中 @JoinColumn 写成了 user_id，TypeORM 生成的 ON 条件会出错或失效。
解决：严格核对数据库 schema 和实体代码中的 @JoinColumn({ name: 'actual_column_name' })。
陷阱 2：缺少反向关系导致无法 Join
如果只在 Order 实体中定义了 @ManyToOne(() => User)，而在 User 实体中没有定义 @OneToMany(() => Order)，你仍然可以通过 Order 实体去 Join User，但不能通过 User 实体去 Join Order（除非使用手动字符串 Join）。
解决：确保双向关系都正确定义，或者在 QueryBuilder 中从拥有外键的一方发起查询。
陷阱 3：手动指定无关系的 Join
如果两张表在数据库中没有外键约束，或者实体中没有定义关系，你需要手动指定 ON 条件。
userRepository
.createQueryBuilder('user')
.leftJoin('logs', 'log', 'log.user_id = user.id') // 手动指定 ON 条件
.getMany();
浙公网安备 33010602011771号