如何将 SQLite 作为你的 Nextjs 项目数据库

创建新的 NextJS 项目

参考 Next.js 官方文档

这一步是新建一个小白鼠项目，如果你已经有了一个现成的项目，尽管使用它（如果担心操作出现失误，记得备份原文件，或者直接创建新的项目吧）

创建一个新的文件夹，创建新的nextjs项目，然后进入这个文件。（配置全部采用默认设置）

npx create-next-app@latest your_project_name
cd your_project_name

或者，你已经创建了文件夹，你可以直接在这个文件夹中创建（我比较喜欢这个方式）

npx create-next-app@latest .

然后，安装默认依赖：

npm i

初始化 Prisma

参考 Prisma 快速开始文档

安装 prisma：

# npm i -D prisma # -D 是指在开发环境下安装
npm i prisma # 在生产环境下安装

安装使用时会用到的客户端组件：

npm i @prisma/client

生成 prisma 文件：

npx prisma init

这之后，你可以发现我们多了两个文件夹和文件：

• ./prisma/schema.prisma：这个文件是我们设置数据库的主要阵地
• ./env：我们在这里配置数据库的url，它代表了数据库的地址，一般填云数据库的链接。但我们这次用的是本地的sqlite，因此这里可以填写文件夹路径，接下来会讲到

配置 SQLite 参数

点进 ./prisma/schema.prisma 文件，让我们开始设置SQLite作为prisma使用的数据库。

首先再次提示，prisma自身不是一个数据库，因此我们需要将它连接到已有的数据库当中。它支持各种数据库，postgre、mysql、mongodb，以及sqlite。

事实上，prisma已经为我们集成了SQLite的创建和使用命令，我们可以只用简单的设置就可以使用sqlite作为我们的数据库。

接下来让我们开始配置，我们需要配置prisma连接的数据库路径。

datasource db 就是prisma连接数据库的方式，让我们更改 provider url，将数据库设置到 prisma 文件夹下的 ./dev.db 中（现在还没有，之后的操作中会自动生成）

// ...
datasource db {
  provider = "sqlite"
  url      = "file:./dev.db"
}
// ...

设置model参数，这是在设置关系数据库的"实例"，也就是一般情况下我们所说的"表"的概念。

当然，prisma的语法和使用并不是我们的重点（虽然它在js项目中确实很好用），因此我们直接用官方文档中设计的两个表，添加到 ./prisma/schema.prisma 文件的最后：

model User {
  id    Int     @id @default(autoincrement())
  email String  @unique
  name  String?
  posts Post[]
}

model Post {
  id        Int     @id @default(autoincrement())
  title     String
  content   String?
  published Boolean @default(false)
  author    User    @relation(fields: [authorId], references: [id])
  authorId  Int
}

这里我们创建了两个表，分别是"User"表和"Post"表（代表"用户"和"发布"，也许用于博客平台）。

通过 Prisma Migrate 命令创建数据库

已经配置好所有内容，我们可以开始创建了。

Prisma Migrate 命令被用来创建和迁移数据库，我们使用后再讲解：

npx prisma migrate dev --name init

"--name init" 用于为这次迁移命名，init可以被更改

你可以观察到，prisma文件夹下多了四个文件：

prisma/
	└─ migrations/
		└─ 20240406161359_init/
				└─ migration.sql
		└─ migration_lock.toml
	└─ dev.db
	└─ dev.db-journal

根据官方文档，这个命令实际上做了三件事情：

1. 它在 prisma/migrations 目录中为此迁移创建了一个新的 SQL 迁移文件。这个SQL文件放在文件夹 20240406161359_init 中，前缀是时间，后缀"init"是我们在命令中设定的，还记得吗（ --name init）

2. 它对数据库执行了 SQL 迁移文件。

3. 它在运行了 prisma generate 命令（安装 @prisma/client 软件包并根据您的模型生成量身定制的 Prisma 客户端 API）。

但我们只关心其中的几个：

• prisma\migrations\20240406161359_init\migration.sql 这是prisma进行迁移的sql命令文件。上面的命令自动生成了执行数据库迁移操作的sql命令文件（所以其实是通过sql进行数据处理的），并通过文件夹命名的方式记录这次迁移的时间和操作名字
• prisma\dev.db 这就是我们本地的sqlite数据库保存的位置

到这里，我们就已经完成了sqlite数据库的创建。

通过 Prisma Studio 测试数据库

使用 prisma studio 来快速测试你的数据库，我们可以像填写excel表格一样增删改查数据库中的数据，只需要一个简单的命令：

npx prisma studio

你会发现prisma自动打开了网页，网址为 localhost/5555

这就是我们的数据库了，尝试创建数据。

进入user表，填写name，email（id留空，它是自增的，不需要填写）。

如果成功创建，那么恭喜你，这个数据库已经可用！