Lucia Auth 项目中使用 Prisma 适配器时遇到的 ID 类型问题解析

问题背景

在使用 Lucia Auth 身份验证库与 Prisma ORM 结合开发时，开发者可能会遇到关于 ID 类型的兼容性问题。特别是在使用 CockroachDB 作为数据库后端时，这个问题尤为突出。

错误现象

开发者在使用 Lucia Auth 的 Prisma 适配器时，尝试创建用户会话时遇到了以下错误：

Invalid value for argument `id`: invalid digit found in string. Expected big integer String.

这个错误表明 Prisma 期望接收一个 BigInt 类型的 ID 字符串，但实际传递的是一个不符合要求的字符串格式。

根本原因

Lucia Auth 的设计要求用户和会话的 ID 必须是字符串类型，而开发者的初始 Prisma 模型定义中将这些字段设置为 BigInt 类型：

model User {
  id             BigInt    @id @default(autoincrement())
  // ...
}

model Session {
  id        BigInt   @id @default(autoincrement())
  // ...
}

这种类型不匹配导致了上述错误。Lucia Auth 生成的 ID 是标准的字符串格式，无法自动转换为 BigInt 类型。

解决方案

正确的做法是将 Prisma 模型中的 ID 字段类型修改为 String：

model User {
  id             String    @id
  email          String    @unique
  hashedPassword String
  createdAt      DateTime  @default(now())
  session        Session[]
}

model Session {
  id        String   @id
  userId    String
  expiresAt DateTime
  user      User     @relation(fields: [userId], references: [id], onDelete: Cascade)
}

同时，在应用代码中使用 Lucia Auth 提供的 generateId 方法来生成用户 ID：

import { generateId } from "lucia";

const userId = generateId(15);
const data = await ctx.db.user.create({
  data: {
    id: userId,
    email: input.email,
    hashedPassword: hashedPassword,
  },
});

注意事项

1. 数据库迁移：修改模型后，必须执行 Prisma 迁移命令将更改应用到数据库。

2. 开发环境重启：在某些情况下，可能需要重启开发服务器才能使 Prisma 客户端更新生效。

3. ID 生成策略：Lucia Auth 提供了自己的 ID 生成机制，应该使用它而不是依赖数据库的自增 ID。

4. 类型一致性：确保所有相关模型中的关联字段类型一致，特别是外键关系。

最佳实践

1. 在设计身份验证系统时，提前规划好 ID 的生成策略。

2. 在开发过程中，注意 Prisma 模型定义与使用的身份验证库之间的兼容性。

3. 对于生产环境，考虑使用更健壮的 ID 生成策略，如 UUID。

4. 定期检查 Prisma 和 Lucia Auth 的文档，了解最新的类型要求和最佳实践。

通过遵循这些指导原则，开发者可以避免类似的类型不匹配问题，并构建更稳定可靠的身份验证系统。