NestJS 一对一关系外键为空、约束失效问题及可运行实现示例咨询

• 关联配置逻辑错位：当前代码中UserEntity加了@JoinColumn()注解，意味着外键字段会创建在user表上，指向customer表的主键。但插入流程中从未给关联字段赋值，数据库自然会写入null。
• 主键设计不合理：CustomerEntity使用@PrimaryColumn作为主键，没有配置自增属性，手动插入时如果没有传入匹配的ID，TypeORM无法完成关联匹配。
• 服务层逻辑缺失：仅定义实体关联注解，没有在数据插入的业务逻辑中显式传入关联实体的引用，TypeORM不会自动将普通请求参数映射到关联属性上。

• 明确外键落表位置：带@JoinColumn()的一侧就是外键存储的表，可通过注解的name参数显式指定外键字段名，避免自动生成的字段名和预期不一致。
• 调整主键配置：将CustomerEntity的@PrimaryColumn替换为@PrimaryGeneratedColumn，适配自增主键的通用场景，减少手动赋值的遗漏。
• 补全业务层关联赋值：在Service层的插入逻辑中，显式将关联实体赋值给实体的关联属性，触发TypeORM写入对应的外键值。
• 开启SQL日志排查：在TypeORM配置中开启logging: true，打印实际执行的INSERT语句，直接定位外键字段值为null的根因。

修正后的实体定义 #

user.entity.ts #

import { CustomerEntity } from "src/customers/customer.entity";
import { Entity, PrimaryGeneratedColumn, Column, OneToOne, JoinColumn } from "typeorm";

@Entity('user')
export class UserEntity {
  @PrimaryGeneratedColumn()
  id: number;

  @Column({ type: "integer" })
  userId: number;

  // 外键字段为user表的customer_id，关联customer表的主键
  @OneToOne(() => CustomerEntity, (customer) => customer.user, {
    cascade: true // 开启级联保存，支持创建用户时同步插入关联的客户数据
  })
  @JoinColumn({ name: 'customer_id' })
  customer: CustomerEntity;
}

customer.entity.ts #

import { UserEntity } from "src/users/user.entity";
import { Entity, PrimaryGeneratedColumn, Column, OneToOne } from "typeorm";

@Entity('customer')
export class CustomerEntity {
  @PrimaryGeneratedColumn()
  id: number;

  @Column({ type: "integer" })
  sample: number;

  @OneToOne(() => UserEntity, (user) => user.customer)
  user: UserEntity;
}

对应的Service层正确插入逻辑 #

import { Injectable, BadRequestException } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { UserEntity } from './user.entity';
import { CustomerEntity } from 'src/customers/customer.entity';

@Injectable()
export class UsersService {
  constructor(
    @InjectRepository(UserEntity) private userRepo: Repository<UserEntity>,
    @InjectRepository(CustomerEntity) private customerRepo: Repository<CustomerEntity>
  ) {}

  async createUserWithRelation(createUserDto: {
    userId: number;
    customerId?: number;
    sample?: number;
  }) {
    // 场景1：关联已存在的客户记录
    if (createUserDto.customerId) {
      const existCustomer = await this.customerRepo.findOneBy({
        id: createUserDto.customerId
      });
      if (!existCustomer) throw new BadRequestException('关联客户不存在');

      // 必须显式给关联属性赋值，否则外键写入null
      const newUser = this.userRepo.create({
        userId: createUserDto.userId,
        customer: existCustomer
      });
      return this.userRepo.save(newUser);
    }

    // 场景2：同时新建用户和关联客户（依赖之前配置的cascade特性）
    const newUser = this.userRepo.create({
      userId: createUserDto.userId,
      customer: {
        sample: createUserDto.sample
      }
    });
    return this.userRepo.save(newUser);
  }
}

• 不要期望Postman传入的普通customerId参数会自动映射到customer关联属性上，必须在Service层手动查询后赋值给关联字段。
• 检查数据库实际表结构，确认外键是否创建在预期的表上：如果@JoinColumn注解位置放错，外键会创建在customer表上，user表自然不会存储关联值。
• 不要依赖实体定义自动创建表结构时的字段映射，建议提前核对外键列的名称和可空属性配置。

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