# Prisma 6 中的类型安全查询使用 Prisma 生成的类型、用于自定义片段的“Prisma.validator”和用于类型推断的“GetPayload”确保所有数据库查询中的类型安全。 ## 生成的类型 Prisma 自动从您的架构生成 TypeScript 类型。 **基本用法：** 从'@prisma/client'导入{Prisma，用户}；异步函数 getUser(id: string): Promise { 返回 prisma.user.findUnique({ 其中：{ id } }); } **与关系：** 类型 UserWithPosts = Prisma.UserGetPayload<{ include: { posts: true } }>; 异步函数 getUserWithPosts(id: string): Promise { 返回 prisma.user.findUnique({ 其中：{id}，包括：{帖子：true}， }); } ## 用于自定义类型的 Prisma.validator 使用 Prisma.validator 创建可重用、类型安全的查询片段。 // 查询验证器 const userWithProfile = Prisma.validator()({ 包括：{ 简介：真实，帖子：{ 其中：{已发布：true}， orderBy: { createAt: 'desc' }, }, }, }); 类型 UserWithProfile = Prisma.UserGetPayload; 异步函数 getCompleteUser(id: string): Promise { 返回 prisma.user.findUnique({ 其中：{id}， ...用户与个人资料， }); } // 输入验证器 const createUserInput = Prisma.validator()({ 电子邮件：'user@example.com'，名称：“约翰·多伊”， profile: { create: { bio: '软件开发人员' } }, }); 异步函数 createUser(data: typeof createUserInput) { 返回 prisma.user.create({ 数据 }); } // where 子句验证器 const activeUsersWhere = Prisma.validator()({ 是否活跃：真实，已删除：空，帖子：{ 一些：{ 已发布：true } }， }); 异步；函数findActiveUsers() { 返回 prisma.user.findMany({ 其中：activeUsersWhere }); } ## 获取有效负载模式使用“GetPayload”从查询形状推断类型。 // 复杂选择 const postWithAuthor = Prisma.validator()({ 选择：{ id：真实，标题：真实，内容：真实，作者：{ 选择：{ id：true，姓名：true，电子邮件：true } }，标签：{ 选择：{ id：true，名称：true } }， }, }); type PostWithAuthor = Prisma.PostGetPayload; 异步函数 getPostDetails(id: string): Promise { 返回 prisma.post.findUnique({ 其中：{id}， ...postWithAuthor， }); } // 嵌套GetPayload 类型 UserWithPostsAndComments = Prisma.UserGetPayload<{ 包括：{ 帖子：{ 包括：{ 评论：{ 包括：{ 作者：true } }； }; }; }; }>; const userArgs = Prisma.validator()({ 包括：{ 帖子：{ 包括：{ 评论：{ 包括：{ 作者：true } }， }, }, }, }); 异步函数 getUserWithActivity(id: string): Promise { 返回 prisma.user.findUnique({ 其中：{id}， ...用户参数， }); } ## 避免“任何” 利用 TypeScript 的类型系统而不是“any”。 // 类型安全的部分选择函数 buildUserSelect( 选择：T ): Prisma.UserGetPayload<{ 选择: T }> |空{ 返回 prisma.user.findFirst({ select }) as any; } 类型 UserBasic = Prisma.UserGetPayload<{ 选择：{ id：true；电子邮件：真实；名称：真实}； }>; const userSelect = Prisma.validator()({ id：真实，电子邮件：真实，名称：真实， }); 异步函数 getUserBasic(id: string): Promise { 返回 prisma.user.findUnique({ 其中：{id}，选择：用户选择， }); } // 类型安全的查询构建器类 TypedQueryBuilder { 构造函数（私有模型：字符串）{} async findMany(args?: A): Promise[]> { 返回 prisma.user.findMany(args); } 异步 findUnique ( 参数：Prisma.SelectSubset ): Promise |空> { 返回 prisma.user.findUnique(args); } } const userQuery = new TypedQueryBuilder('用户'); const 用户 = 等待 userQuery.findMany({ 其中：{ isActive: true }, 包括：{帖子：true}， }); // 条件类型类型 UserArgs = T extends true ？ Prisma.UserGetPayload<{ include: { posts: true } }> : Prisma.UserGetPayload<{ 选择: { id: true;电子邮件：true } }>; 异步函数 getUser( id：字符串，包含帖子：T ): Promise |空> { 如果（包括帖子）{ 返回 prisma.user.findUnique({ 其中：{id}，包括：{帖子：true}， }) 作为 Promise |空>; } 返回 prisma.user.findUnique({ 其中：{id}，选择：{ id：true，电子邮件：true }， }) 作为 Promise |空>; } ## 高级模式 **可重复使用的类型安全包括：** 常量包括 = { userWithProfile: Prisma.validator()({ 包括：{配置文件：true}， }), userWithPosts: Prisma.validator()({ 包括：{ posts: { where: {published: true } } }, }), userComplete: Prisma.validator()({ 包括：{个人资料：true，帖子：true，评论：true}， }), 作为常量；类型 UserWithProfile = Prisma.UserGetPayload; 类型 UserWithPosts = Prisma.UserGetPayload; type UserComplete = Prisma.UserGetPayload; 异步函数 getUserVariant( id：字符串，变体： keyof typeof 包括 ): Promise { 返回 prisma.user.findUnique({ 其中：{id}， ...包括[变体]， }); } **类型安全的动态查询：** 类型 DynamicUserArgs = { 包含配置文件？：布尔值； includePosts？：布尔值；包括注释？：布尔值； }; 函数 buildUserArgs(选项：DynamicUserArgs): Prisma.UserDefaultArgs { const args: Prisma.UserDefaultArgs = {}; if (options.includeProfile || options.includePosts || options.includeComments) { args.include = {}; if (options.includeProfile) args.include.profile = true; if (options.includePosts) args.include.posts = true; if (options.includeComments) args.include.comments = true; } 返回参数； } 异步函数 getDynamicUser(id: string, options: DynamicUserArgs) { 返回 prisma.user.findUnique({ 其中：{id}， ...buildUserArgs(选项), }); } ## 关键原则 1. 始终使用`@prisma/client`生成的类型 2. 使用 `Prisma.validator` 来实现可重用的查询片段 3. 通过“GetPayload”从查询形状派生类型 4. 避免使用“任何”；利用 TypeScript 的类型系统 5. 使用适当的泛型键入动态查询 6. 为常见模式创建常量验证器 ## 相关技能 **TypeScript 类型安全：** * 如果避免 TypeScript 中的任何类型，请使用 TypeScript 中的避免任何类型技能来实现严格的类型模式 * 如果为类型安全查询实现泛型模式，请使用打字稿中的 using-generics 技能来实现高级泛型技术

确保查询类型安全

包含技能