配置指南
项目如何配置使用neon数据库
Created: 01/01/2026
Updated: 01/23/2026
项目可使用 PostgreSQL 作为数据库系统,使用 Drizzle ORM 进行数据库访问和管理。
创建数据库
推荐使用托管的 PostgreSQL 数据库服务,它们提供简单的设置和管理,并且通常包含足够入门的免费套餐
设置步骤
1、在 neon.tech 创建账户

2、创建新项目

3、创建数据库

4、从仪表盘获取连接字符串

5、将连接字符串作为 DATABASE_URL 添加到项目根目录下 .env 或者 .env.production 或者 .env.development 文件中
(1)部署在Vercel的看下面

Neon 连接字符串示例:
DATABASE_URL="postgresql://neondb_owner:xxxxx@ep-soft-credit-xxxxx-pooler.c-2.us-west-2.aws.neon.tech/neondb?sslmode=require&channel_binding=require"
(2)部署在Cloudflare的看下面
需要将Connection pooling关闭掉,这样后面配置Hyperdrive才能加速成功

Neon 连接字符串示例:
postgresql://neondb_owner:xxxxxxx@ep-rough-tooth-ahvvw9t5.c-3.us-east-1.aws.neon.tech/neondb?sslmode=require&channel_binding=require
然后再回到:项目快速上手图文教程 进行数据库初始化等一系列操作
延伸:部署在Cloudflare的Hyperdrive配置(如果你是部署在Vercel的不需要看)
下面这块写的建立在你已经会用hyperdrive了,但你之前可能是配置Supabase的hyperdrive 成功了;这里专门说下基于Neon数据库怎么配置
以根目录/wrangler.toml为例
[[hyperdrive]]
binding = "HYPERDRIVE"
id = "14ff0c07d67940139cd99d7673a952a8"
# 将上面的`Neon 连接字符串值`改写为下面格式(下面只是值参考,不能完全复制粘贴)
# 这个localConnectionString的值可以用于Cloudflare的Hyperdrive新建时录入的值
localConnectionString = "postgres://neondb_owner:xxxxx@ep-rough-tooth-ahvvw9t5.c-3.us-east-1.aws.neon.tech/neondb?sslmode=require"

创建成功后更新掉wrangler.toml中(也就是上面代码中)的[[hyperdrive]]的id值

然后执行pnpm cf:deploy部署成功后 稍等片刻就能看到加速成功了
