Prisma中通过User关联查询指定地址Lot的问题排查

问题说明 #

使用Prisma查询邮箱为xyz@gmail.com的用户，同时筛选出关联Lot地址为123 St, Find Me Town的LotInterest，但返回的lotInterests始终是空数组，实际期望能得到包含目标Lot的关联结果。

尝试的查询代码 #

const foundLot = await prisma.user.findUnique({
  where: {
    email: "xyz@gmail.com"
  },
  include: {
    lotInterests: {
      include: { lot: true },
      where: {
        lot: {
          address: "123 St, Find Me Town"
        }
      }
    }
  }
})

数据库Schema #

model User {
  id            String    @id @unique @default(cuid())
  name          String?
  email         String?   @unique
  lotInterests  LotInterest[]
}

model LotInterest {
  id                String @default(cuid()) @id

  // Relation Fields
  userId       String?  
  lotId        String? 
  user         User?   @relation(fields: [userId], references: [id])
  lot          Lot?    @relation(fields: [lotId], references: [id])
  @@unique([userId, lotId])
  @@index([userId, role])
}

model Lot {
  id            String  @id @unique @default(cuid())
  zipCode       String
  address       String  @unique

  // Relation fields
  interest LotInterest[]
}

问题排查与原因 #

1. 可选关联字段导致匹配失败：LotInterest中的userId和lotId是可选字段（带?），如果数据库中对应的记录这两个字段为null，Prisma无法建立关联关系，自然筛选不到结果。
2. Schema存在笔误：LotInterest模型中的@@index([userId, role])里的role字段未定义，虽然不直接影响查询，但会导致Schema校验警告，可能间接引发关联解析问题。
3. 数据匹配问题：需确认数据库中确实存在该用户关联的LotInterest，且对应的Lot记录地址完全匹配123 St, Find Me Town（注意大小写、空格等细节）。

解决方案 #

方案1：修正Schema的关联字段为必填（推荐，符合业务逻辑） #

如果业务要求LotInterest必须同时关联User和Lot，将userId、lotId及对应的关联模型改为必填，删除?：

model LotInterest {
  id                String @default(cuid()) @id

  // Relation Fields
  userId       String  
  lotId        String 
  user         User   @relation(fields: [userId], references: [id])
  lot          Lot    @relation(fields: [lotId], references: [id])
  @@unique([userId, lotId])
  @@index([userId]) // 移除不存在的role字段，修正索引
}

方案2：调整查询条件，兼容可选字段 #

如果必须保留可选字段，在查询时添加非空判断，确保关联关系有效：

const foundLot = await prisma.user.findUnique({
  where: {
    email: "xyz@gmail.com"
  },
  include: {
    lotInterests: {
      include: { lot: true },
      where: {
        userId: { not: null },
        lotId: { not: null },
        lot: {
          address: "123 St, Find Me Town"
        }
      }
    }
  }
})

额外验证步骤 #

• 直接查询Lot表，确认存在地址为123 St, Find Me Town的记录
• 查询LotInterest表，确认存在该用户ID和目标LotID关联的记录

调整后期望返回结果 #

{
  id: 'cljxsmdxw0094hkgkgn8urnrv',
  name: 'XYZ',
  email: 'xyz@gmail.com',
  lotInterests: [
    {
      id: 'cljxsn1230095hkgkgn8urabc',
      userId: 'cljxsmdxw0094hkgkgn8urnrv',
      lotId: 'cljxsn4560096hkgkgn8urdef',
      lot: {
        id: 'cljxsn4560096hkgkgn8urdef',
        zipCode: '12345',
        address: "123 St, Find Me Town"
        // 其他Lot字段
      }
    }
  ]
}

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