Prisma 查询未返回 Schema 中指定的数组？原因及解决方案-js教程-PHP中文网

Prisma 查询未返回 Schema 中指定的数组？原因及解决方案

心靈之曲

发布： 2025-07-28 14:30:28

原创

208人浏览过

prisma 查询未返回 schema 中指定的数组？原因及解决方案

在使用 Prisma 进行数据库查询时，有时会遇到 Schema 中定义的关联数组未被返回的问题。这通常是因为在查询时没有显式地指定要包含这些关联数据。本文将深入探讨这一问题的原因，并提供详细的解决方案，确保您能正确获取关联数据，构建健壮的应用。

在使用 Prisma 时，即使数据库中存在关联数据，但如果查询语句中没有明确指示包含这些数据，Prisma 默认不会返回它们。这通常发生在尝试获取包含关联数组（例如一对多关系中的子项列表）的模型时。

原因分析

Prisma 旨在提供高效的数据查询，默认情况下，它只返回模型自身的数据，而不会自动加载关联数据。这种设计避免了不必要的性能开销，尤其是在关联数据量很大时。因此，如果您需要获取关联数据，必须在查询语句中使用 include 或 select 选项显式指定。

解决方案

要解决查询未返回 Schema 中指定的数组的问题，您需要在查询语句中明确指示 Prisma 包含关联数据。这可以通过 include 选项来实现。

以下代码演示了如何使用 include 选项来获取 ShoppingList 以及其关联的 ShoppingListItem 数组：

const list = await prisma.shoppingList.findUnique({
  where: {
    id: input.id,
  },
  include: {
    items: true,
  },
});

登录后复制

在这个例子中，include: { items: true } 告诉 Prisma 在查询 ShoppingList 时，同时获取并包含所有关联的 ShoppingListItem。

因赛AIGC

因赛AIGC解决营销全链路应用场景

查看详情

示例

假设我们有以下 Prisma Schema 定义了 ShoppingList 和 ShoppingListItem 之间的关系：

model ShoppingListItem {
  id             String       @id @default(cuid())
  name           String
  shoppingList   ShoppingList @relation(fields: [shoppingListId], references: [id])
  shoppingListId String
  markedDone     Boolean      @db.Boolean @default(false)
  addedById      String
  createdAt      DateTime     @default(now())
  updatedAt      DateTime     @updatedAt

  @@index([addedById, shoppingListId])
}

model ShoppingList {
  id          String             @id @default(cuid())
  name        String
  items       ShoppingListItem[]
  testArray   String[]
  createdById String
  createdAt   DateTime           @default(now())
  updatedAt   DateTime           @updatedAt
  HouseHold   HouseHold?         @relation(fields: [houseHoldId], references: [id])
  houseHoldId String?

  @@index([id])
}

登录后复制

如果我们想获取一个 ShoppingList 以及其所有的 ShoppingListItem，我们需要使用 include 选项：

const shoppingList = await prisma.shoppingList.findUnique({
  where: {
    id: 'some-shopping-list-id',
  },
  include: {
    items: true,
  },
});

console.log(shoppingList); // 这将包含 ShoppingList 的所有信息，以及一个包含所有关联 ShoppingListItem 的数组。

登录后复制

注意事项

性能考虑： 虽然 include 选项很方便，但在处理大量关联数据时，可能会影响性能。请根据实际情况谨慎使用。
选择性包含： 如果只需要关联数据中的特定字段，可以使用 select 选项来代替 include，以提高查询效率。
类型安全： 确保您的 TypeScript 类型定义与 Prisma Schema 保持同步，以便获得正确的类型提示和编译时检查。

总结

在使用 Prisma 查询关联数据时，务必记住使用 include 选项显式指定要包含的关联模型。这可以确保您获取到完整的数据，并避免潜在的错误。同时，请注意性能优化，根据实际需求选择合适的查询方式。通过理解 Prisma 的数据加载机制，您可以更有效地使用 Prisma 构建高效、可靠的应用程序。

以上就是Prisma 查询未返回 Schema 中指定的数组？原因及解决方案的详细内容，更多请关注php中文网其它相关文章！