Prisma 查询未返回 Schema 中指定的数组：解决方案与最佳实践-js教程-PHP中文网

Prisma 查询未返回 Schema 中指定的数组：解决方案与最佳实践

DDD

发布： 2025-07-28 14:22:01

原创

585人浏览过

prisma 查询未返回 schema 中指定的数组：解决方案与最佳实践

在使用 Prisma 进行数据库查询时，有时会遇到 Schema 中定义的关联数组未被返回的问题。本文将深入探讨此问题的原因，并提供详细的解决方案和最佳实践，帮助开发者避免类似错误，确保数据查询的完整性和准确性。核心在于理解 Prisma 的 include 选项，以及如何在查询中正确使用它来获取关联数据。

在使用 Prisma 进行数据库查询时，如果关联数组（例如一对多关系中的子表数据）没有在查询结果中返回，主要原因通常是查询语句中缺少显式的包含声明。Prisma 默认情况下不会自动包含所有关联数据，需要使用 include 或 select 选项来指定需要返回的关联关系。

以下将详细解释如何解决这个问题，并提供一些最佳实践。

解决方案：使用 include 选项

在 Prisma 查询中，include 选项用于指定需要包含的关联数据。对于上述问题，需要在 shoppingList.findUnique 查询中包含 items 字段，才能返回 ShoppingListItem 数组。

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

登录后复制

这段代码会将 ShoppingList 以及与其关联的所有 ShoppingListItem 一起返回。

代码示例：完整的查询过程

下面是一个完整的代码示例，展示了如何使用 include 选项来获取关联数据：

Prisma

Prisma是一款照片编辑工具，用户可以轻松地将照片转换成数字艺术。

查看详情

import { PrismaClient } from '@prisma/client';
import { z } from 'zod';
import { TRPCError } from '@trpc/server';

const prisma = new PrismaClient();

// 假设你使用了 tRPC
const publicProcedure = { // 替换为你实际的 publicProcedure 定义
  input: (schema: z.ZodType<any>) => ({
    parse: (input: any) => schema.parse(input),
  }),
  query: (resolver: any) => resolver,
};

const getShoppingListById = publicProcedure
  .input(
    z.object({
      id: z.string(),
    })
  )
  .query(async ({ input }) => {
    const list = await prisma.shoppingList.findUnique({
      where: {
        id: input.id,
      },
      include: {
        items: true, // 包含关联的 ShoppingListItem
      },
    });

    if (!list) {
      throw new TRPCError({ code: 'NOT_FOUND' });
    }

    return list;
  });

// 使用示例
async function main() {
  try {
    const shoppingList = await getShoppingListById.query({ input: { id: 'clhnzfqy80000vv27ahbbk0xz' } }); // 替换为你的 ShoppingList ID
    console.log(shoppingList);
  } catch (error) {
    console.error(error);
  } finally {
    await prisma.$disconnect();
  }
}

main();

登录后复制

注意事项：select 选项

除了 include，Prisma 还提供了 select 选项，它允许你更精细地控制返回的字段。select 可以选择包含关联数据，也可以选择只包含关联数据的特定字段。

例如，如果只想获取 ShoppingListItem 的 id 和 name 字段，可以使用 select：

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

登录后复制

最佳实践：性能优化

当关联数据量很大时，使用 include: true 可能会导致性能问题。在这种情况下，可以考虑以下优化策略：