TypeORM使用主键作为外键配置一对一关联报错求助

开发者阿泽

2026-7-16

TypeORM 一对一关联（主键作为外键）配置错误解决方法

问题原因

你在Profile实体中错误地将同一个字段user同时标记为@PrimaryColumn和@OneToOne关联字段。TypeORM无法同时处理一个字段既是原始字符串类型的主键，又是User实体类型的关联字段，这导致保存时类型冲突，抛出Cannot create property 'user' on string 'my-user-id'错误。

解决方案

方案1：分离主键字段与关联字段

将Profile的主键字段和关联字段分开，明确各自的职责：

// Profile实体修正后
import { BaseEntity, Entity, JoinColumn, OneToOne, PrimaryColumn } from "typeorm";
import { User } from "./User";

@Entity()
export class Profile extends BaseEntity {
    // 主键字段，与User的主键类型一致
    @PrimaryColumn()
    userId: string;

    // 一对一关联字段，通过userId作为外键关联User
    @OneToOne(() => User)
    @JoinColumn({ name: "userId" })
    user: User;
}

测试代码调整为：

const userEntity = User.create({
    user: "my-user-id",
});

await userEntity.save();

const profileEntity = Profile.create({
    userId: userEntity.user,
    user: userEntity
});

await profileEntity.save();

方案2：直接将关联字段设为主键（推荐）

利用TypeORM的@OneToOne装饰器的primary: true选项，直接把关联字段作为Profile的主键，无需额外定义主键字段：

// Profile实体修正后
import { BaseEntity, Entity, JoinColumn, OneToOne } from "typeorm";
import { User } from "./User";

@Entity()
export class Profile extends BaseEntity {
    @OneToOne(() => User, { primary: true })
    @JoinColumn({ name: "user" }) // 指定外键列名为user，与User的主键列对应
    user: User;
}

测试代码可以保持原写法不变：

const userEntity = User.create({
    user: "my-user-id",
});

await userEntity.save();

const profileEntity = Profile.create({
    user: userEntity,
});

await profileEntity.save();