Prisma显式多对多关系下创建或关联记录的实现

你当前定义的带自定义字段的显式多对多Schema结构是完全正确的，由于List和Book之间没有直接关联，所有关联逻辑都需要围绕BooksInLists中间表展开，两类操作都可以通过Prisma原生的嵌套写能力实现，不需要手动拆分多步数据库查询，具体实现如下：

1. 向列表添加全新书籍（同步创建Book记录 + 带备注的中间表记录） #

该场景需要嵌套两层create操作：从List的更新入口创建中间表的BooksInLists记录，再在这条中间记录下嵌套创建全新的Book记录，Prisma会自动完成两个表的外键绑定，全程在单事务内执行。

// 入参：目标列表ID、新书基础信息、对应书籍的列表专属备注、当前操作用户ID
const targetListId = 1
const newBookBaseInfo = {
  name: "《深入理解计算机系统》",
  bookDescription: "计算机专业核心经典教材",
  curatorId: 2 // 书籍的归档负责人ID
}
const customNote = "大三上学期反复读了3遍的重点教材"
const currentUserId = 3

await prisma.list.update({
  where: { id: targetListId },
  data: {
    // 通过List的关联字段操作中间表记录
    books: {
      create: {
        notes: customNote,
        adderId: currentUserId,
        // 在中间表记录下嵌套创建全新的Book实体
        book: {
          create: newBookBaseInfo
        }
      }
    }
  }
})

• 全程为单事务执行，不会出现Book创建成功但中间表关联失败的孤立数据
• 支持批量添加多本新书：将books.create替换为books.createMany，每个元素套用上述嵌套结构即可

2. 向列表关联已有书籍（仅创建带备注的中间表记录） #

该场景下Book实体已经存在，不需要新建，只需要在创建中间表记录时，通过connect操作绑定已有的Book主键即可。

// 入参：目标列表ID、已存在的书籍ID、对应书籍的列表专属备注、当前操作用户ID
const targetListId = 1
const existingBookId = 12
const customNote = "配套阅读的参考书，重点标注第三章内容"
const currentUserId = 3

await prisma.list.update({
  where: { id: targetListId },
  data: {
    books: {
      create: {
        notes: customNote,
        adderId: currentUserId,
        // 直接绑定已存在的Book实体
        book: {
          connect: { id: existingBookId }
        }
      }
    }
  }
})

• 由于当前中间表定义了@@id([listId, bookId])的联合主键，同一本书无法重复关联到同一个列表，重复操作会触发数据库唯一约束报错，业务侧可以提前做存在性校验，或者结合upsert做重复操作的兼容
• 同样支持批量关联多本已有书籍，调整为createMany结构即可

边界踩坑提示 #

• 如果业务需要允许同一本书以不同备注重复出现在同一个列表（比如标记不同阅读阶段的笔记），需要将BooksInLists的联合主键替换为单独的自增ID字段作为主键，避免被唯一约束拦截
• 写入操作前需要先校验当前操作用户是否匹配List.authorId，防止越权修改他人的列表

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