TypeORM多OneToOne关联失效问题（NestJS+现有数据库场景）

问题根源 #

TypeORM 0.3.x版本中，同一个实体下的多个OneToOne关联如果未显式指定@JoinColumn的关联列名，会因默认命名规则冲突，导致后定义的关联配置覆盖前一个，最终生成错误的SQL关联字段。

解决方案 #

给每个OneToOne关联的@JoinColumn指定唯一的、与现有数据库匹配的列名，确保两个关联的字段配置完全独立。

正确的实体配置示例 #

假设现有数据库中，Article表包含title_id（关联ArticleTitle的主键）和body_id（关联ArticleBody的主键）两个列，实体代码如下：

Article 实体

import { Entity, PrimaryGeneratedColumn, OneToOne, JoinColumn } from 'typeorm';
import { ArticleTitle } from './article-title.entity';
import { ArticleBody } from './article-body.entity';

@Entity()
export class Article {
  @PrimaryGeneratedColumn()
  id: number;

  // 关联ArticleTitle，指定关联列名为title_id
  @OneToOne(() => ArticleTitle)
  @JoinColumn({ name: 'title_id' })
  title: ArticleTitle;

  // 关联ArticleBody，指定关联列名为body_id
  @OneToOne(() => ArticleBody)
  @JoinColumn({ name: 'body_id' })
  body: ArticleBody;
}

ArticleTitle 实体

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

@Entity()
export class ArticleTitle {
  @PrimaryGeneratedColumn()
  id: number;

  @Column()
  content: string;
}

ArticleBody 实体

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

@Entity()
export class ArticleBody {
  @PrimaryGeneratedColumn()
  id: number;

  @Column('text')
  content: string;
}

关键说明 #

• 必须通过@JoinColumn的name参数明确指定当前实体（Article）中存储关联ID的列名，完全匹配现有数据库的字段名。
• 两个OneToOne关联的name参数不能重复，否则会出现配置覆盖问题。
• 如果需要双向关联，可在ArticleTitle和ArticleBody中添加对应的@OneToOne装饰器并指定反向关联属性（比如@OneToOne(() => Article, article => article.title)），但无需额外添加@JoinColumn（JoinColumn只需要在拥有外键的一方配置）。

内容的提问来源于stack exchange，提问作者Cédric Poingt