Node.js TypeORM一对一（零或一）关系查询关联报错解决

错误原因 #

你遇到的42703错误，核心原因有两种可能：

1. PostgreSQL大小写敏感规则：如果issuer表的外键列是驼峰式的userId，原生SQL中直接写issuer.userId会被PostgreSQL自动转成小写的issuer.userid，但数据库实际列名是userId，导致提示列不存在。
2. 实体与数据库未同步：你没有将实体定义同步到数据库，issuer表中根本没有生成userId列。

修正方案 #

方案1：修正原生SQL查询 #

根据实际数据库列名调整SQL：

• 如果列名是驼峰式userId，需用双引号包裹标识符：

SELECT 
  user_data.id, 
  user_data.email, 
  issuer.issuerId
FROM user_data
LEFT JOIN issuer ON "issuer"."userId" = user_data.id
WHERE user_data.email = $1

• 如果列名是蛇形命名user_id（TypeORM默认策略生成）：

SELECT 
  user_data.id, 
  user_data.email, 
  issuer.issuer_id
FROM user_data
LEFT JOIN issuer ON issuer.user_id = user_data.id
WHERE user_data.email = $1

方案2：使用TypeORM QueryBuilder（推荐） #

用ORM方式查询可避免原生SQL的列名匹配问题，先给User实体补充反向关系：

@Entity('user_data')
export class User {
  @PrimaryGeneratedColumn()
  id: number

  @Column({ type: 'varchar', nullable: false, unique: true })
  email: string

  // 添加与Issuer的反向一对一关系
  @OneToOne(() => Issuer, issuer => issuer.user)
  issuer: Issuer
  
  ...remaining columns...
}

再编写查询逻辑：

import { getRepository } from "typeorm";
import { User } from "./entities/User";

async function getUserWithIssuer(email: string) {
  const user = await getRepository(User)
    .createQueryBuilder("user")
    .leftJoinAndSelect("user.issuer", "issuer")
    .select([
      "user.id",
      "user.email",
      "issuer.issuerId"
    ])
    .where("user.email = :email", { email })
    .getOne();

  // 处理返回格式，issuerId为null时自动省略
  return {
    id: user.id,
    email: user.email,
    ...(user.issuer && { issuerId: user.issuer.issuerId })
  };
}

补充说明 #

确保实体定义与数据库结构一致，可通过typeorm schema:sync命令同步实体到数据库。

内容的提问来源于stack exchange，提问作者Ahmet Yazıcı