NestJS+Prisma中如何正确存储树形结构分类数据

报错核心原因 #

Prisma 对模型关联字段做了类型封装，定义自关联关系后，外键字段parentId不会作为create方法的顶层入参直接暴露，关系字段parent仅接受嵌套操作参数，直接传入parentId的数值、或是直接给parent赋值数字ID都不符合类型校验规则，才会触发参数未知的报错。

正确写入实现 #

根据业务场景分两种常用写法：

1. 绑定已存在的父分类（最常用） #

如果父分类已经提前存入数据库，通过connect操作关联父分类ID即可，传入parentId时注意和模型定义的Int类型匹配，前端传字符串的话要提前转数字；如果是创建一级根分类，直接省略parent字段即可。

async createCategory(dto: createCategoryDto) {
    const newCategory = await this.prisma.category.create({
        data: {
            name: dto.name,
            // 有传入父分类ID时才做关联
            ...(dto.parentId && {
                parent: {
                    connect: { id: Number(dto.parentId) }
                }
            })
        }
    });
    return newCategory;
}

2. 创建分类的同时新建父分类 #

如果业务场景是提交分类时父分类还未入库，可以直接在parent字段下嵌套create操作，同时写入父分类数据，Prisma会自动完成两次数据写入和外键关联：

async createCategoryWithNewParent(dto: createCategoryDto) {
    return this.prisma.category.create({
        data: {
            name: dto.name,
            parent: {
                create: {
                    name: dto.parentName // 父分类的对应字段
                }
            }
        }
    })
}

常见避坑点 #

• 不要直接给parent字段传数字ID，该字段是关系操作字段，仅支持connect/create/connectOrCreate这类嵌套关联操作
• 字段类型要和Schema定义对齐：你的模型中parentId是Int类型，不要直接传字符串类型的ID值
• 创建一级根分类时不要给parent传空字符串、0这类无效值，直接省略该字段即可，Prisma会自动给parentId赋值null
• 修改Schema后记得执行npx prisma generate重新生成Prisma Client，避免类型定义和实际Schema不匹配

树形结构查询示例 #

写入完成后要获取带层级的分类树，可以通过include关联查询子节点：

async getCategoryTree() {
    // 先查所有parentId为null的根分类，再关联查询子节点
    return this.prisma.category.findMany({
        where: { parentId: null },
        include: {
            // 按需嵌套层级，需要无限层级可以封装递归方法处理
            children: {
                include: { children: true }
            }
        }
    })
}

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