Vibe Vibe

主题

6.0 领取你的数据库 ​

本节目标：注册一个免费的云端 PostgreSQL 数据库，拿到连接字符串，验证连接成功。

在序言里你已经理解了数据库的概念。现在，动手领一个属于你自己的数据库。

为什么用云端数据库 ​

你可能想问：能不能在自己电脑上装一个 PostgreSQL？当然可以，但老师傅不推荐新手这么做：

  • 本地安装配置繁琐，容易踩坑
  • 部署到线上时还要迁移数据
  • 云端数据库免费套餐对个人项目完全够用

云端数据库的好处是：注册即用、自动备份、随处可访问。你在家写代码连的是它，部署到 Vercel 连的也是它，省去了环境差异的烦恼。

方案一：Neon（推荐） ​

Neon 是一个专注于 PostgreSQL 的无服务器数据库平台——你不用自己装数据库、管服务器，Neon 帮你搞定，你只管连上去用。免费套餐慷慨，冷启动快（冷启动是数据库闲置后第一次被访问时的"热身"延迟），非常适合个人项目。

image-20260222223036476

注册步骤 ​

第一步：访问 Neon 官网

打开 neon.tech，点击右上角 Log In。推荐使用 GitHub 账号登录，一键授权即可。

image-20260222223100463

第二步：创建项目

image-20260222223148855

登录后创建第一个项目（Project）。填写以下信息：

  • Project Name：随便起，比如 my-first-app
  • Region：选择离你最近的区域。国内用户推荐选 Singapore（新加坡），延迟最低
  • Database Name：默认 neondb 即可

image-20260222223211499

第三步：获取连接字符串

项目创建完成后，Neon 会直接展示你的 Connection String（连接字符串）。它长这样：

postgresql://username:password@ep-xxx-xxx-123.us-east-2.aws.neon.tech/neondb?sslmode=require

image-20260222223303602

保管好你的连接字符串

连接字符串包含用户名和密码，相当于数据库的钥匙。绝对不要提交到 GitHub 或发给别人。把它存到项目的 .env 文件里：

bash
DATABASE_URL="postgresql://username:password@ep-xxx.neon.tech/neondb?sslmode=require"

Neon 免费套餐包含什么 ​

资源免费额度
存储空间512 MB
计算时长每个项目100计算
项目数量100 个
分支数量10 个

对于学习和个人项目，这些额度绑绑有余。

方案二：Supabase ​

Supabase 不仅提供 PostgreSQL 数据库，还自带认证、存储、实时订阅等功能。如果你想要一个"全家桶"式的后端服务，可以选它。

注册步骤 ​

第一步：访问 Supabase 官网

打开 supabase.com，点击 Start your project，用 GitHub 登录。

image-20260222223411365

第二步：创建组织和项目

image-20260222223437677

  • Organization：填一个组织名

  • Project Name：比如 my-first-app

  • Database Password：设置一个强密码，记下来

  • Region：选 Southeast Asia (Singapore)

    image-20260222223509375

第三步：获取连接字符串

项目创建后，进入主页，点击顶部 Connect ：

image-20260222223646279

Method 选择 Transaction pooler（这就是前面说的"连接池"的具体实现方式，选它就对了）；如有空还可以配置MCP。

image-20260222224026943

postgresql://postgres.[project-ref]:[YOUR-PASSWORD]@aws-0-ap-southeast-1.pooler.supabase.com:6543/postgres

Supabase 免费套餐包含什么 ​

资源免费额度
数据库存储500 MB
文件存储1 GB
带宽5 GB / 月
项目数量2 个
Edge Functions50 万次 / 月

Neon vs Supabase 怎么选？

  • 只要数据库 → 选 Neon，专注、轻量、免费额度大
  • 想要全家桶（数据库 + 认证 + 存储 + 实时） → 选 Supabase
  • 本教程推荐 Neon，因为我们用标准 PostgreSQL + 独立的认证方案（Better Auth），不被平台捆绑

验证连接 ​

拿到连接字符串后，怎么确认它能用？

方法一：让 AI 帮你验证 ​

最简单的方式，直接告诉 AI：

"用我 .env 里的 DATABASE_URL 测试数据库连接，确认能连上"

AI 会写一段简单的测试脚本，运行后告诉你连接是否成功。

方法二：用 Drizzle Studio 可视化查看 ​

如果你的项目已经配置了 Drizzle ORM，可以运行：

bash
pnpm drizzle-kit studio

浏览器会打开一个可视化界面，你能直接看到数据库里的表和数据。如果能打开，说明连接没问题。

image-20260222230115049

方法三：去平台控制台直接看 ​

最直观的方式是直接打开数据库平台的 Web 控制台，像看 Excel 一样浏览数据。开发时建议常开着控制台页面，随时确认数据是否写入正确。

Neon Console：登录后进入项目，点击左侧 Tables 即可浏览表数据，也可以在 SQL Editor 里直接运行查询。

image-20260222230548275

Supabase Table Editor：登录后进入项目，点击左侧 Table Editor，可以像 Excel 一样直接浏览、筛选、编辑表数据。

image-20260222230528345

常见连接问题 ​

报错信息原因解决方案
Invalid URL连接字符串格式错误检查有没有多余的空格、引号是否匹配
password authentication failed密码错误去平台重置密码，更新 .env
connection refused网络不通检查是否需要 ?sslmode=require（SSL 加密你和数据库之间的通信，防止密码在传输中被截获）
too many connections连接数超限使用连接池（Pooler）地址

连接池是什么？

数据库的每个连接都要消耗 1-3 MB 内存，而且连接数有上限（通常几十到几百个）。如果你的应用每次请求都新建一个连接、用完就断开，很快就会耗尽连接数，后面的用户全部报错。

连接池（Connection Pooler） 就像一个"连接中介"——它预先建好一批数据库连接，应用需要时借一个用，用完还回去，下一个请求复用同一个连接。这样 100 个并发用户可能只需要 10 个数据库连接。

Neon 和 Supabase 都提供连接池地址（通常端口不同，比如 Supabase 的直连是 5432，连接池是 6543）。部署到生产环境时，务必使用连接池地址，否则流量一大就会 too many connections。

把连接字符串配置到项目 ​

在你的 Next.js 项目根目录，创建或编辑 .env 文件：

bash
# 数据库连接（替换成你自己的）
DATABASE_URL="postgresql://username:password@host/dbname?sslmode=require"

确保 .gitignore 里有 .env（Next.js 项目默认已包含）。

然后告诉 AI：

"项目已配置好 DATABASE_URL，请用 Drizzle ORM 初始化数据库连接"

AI 会帮你创建 src/db/index.ts 等文件，把数据库连接跑通。

下一步

数据库领到了，连接也通了。接下来在 6.1 数据存储演进 中，你会理解为什么需要数据库，以及它比 JSON 文件强在哪里。