TypeORM使用QueryBuilder关联时自动生成JOIN条件失效问题排查

你在FaultLogEntity中对alarm字段的关联关系配置错误，是导致JOIN条件无法正常自动生成的直接原因：

// 错误写法：OneToMany表示单条FaultLog对应多条Alarm，不符合你的业务逻辑
@OneToMany(() => AlarmEntity, alarm => alarm.faultLogs)
@JoinColumn({ name: 'alarmId' })
alarm: AlarmEntity;

外键alarmId保存在故障日志表中，实际是多条故障日志对应同一条告警，属于多对一的从属方，正确配置应为：

// 正确写法
@ManyToOne(() => AlarmEntity, alarm => alarm.faultLogs)
@JoinColumn({ name: 'alarmId' })
alarm: AlarmEntity;

• 关联装饰器类型必须和实际表的外键逻辑匹配：@ManyToOne/@OneToMany/@OneToOne/@ManyToMany不能混用
• 双向关联的双方必须正确配置反向映射：从属方关联装饰器的第二个参数，必须正确指向主控方的对应关联字段
• @JoinColumn配置的外键列名必须和数据库实际字段完全一致
• QueryBuilder中关联路径必须为「主表别名.实体定义的关联属性名」，不能直接写表名

• 传入第三个自定义关联条件时生成ON AND (...)非法SQL：TypeORM识别到错误的@OneToMany配置不符合从属方关联逻辑，无法自动生成前置关联条件，拼接自定义条件时就会出现多余的AND关键字
• 把fl.alarm改成alarm后SQL正常：该写法是直接关联表名，TypeORM不会匹配实体关联配置，需要手动补全所有关联条件，属于非标准的临时可用写法
• 另一个项目查询正常：对应项目的实体关联装饰器配置符合业务逻辑，所以可以正常自动生成JOIN条件

将FaultLogEntity的alarm字段装饰器修改为@ManyToOne后，你原本的QueryBuilder写法就可以正常生成带ON a.id = fl.alarmId的正确SQL。

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