使用 Postgres 与 Supabase
把应用指向任意 Postgres 数据库(包括 Supabase 与 Neon),并用迁移链构建 schema。
任何 Postgres 数据库都通过通用的 Drizzle Postgres 适配器接入。Supabase 和 Neon 是同一代码路径上的托管 Postgres 端点。应用不使用 Supabase SDK、认证助手、存储 API 或行级安全策略。
准备工作
- 一个 Postgres 数据库及其连接串,例如 Supabase 的 Project Settings → Database。
- 一台能连上该数据库、用于执行迁移的机器。
- 一个空数据库。不是由迁移链创建的 schema 无法原地迁移。
在托管平台创建数据库
连接数据库
设置连接
DATABASE_DIALECT=postgres
DATABASE_URL=postgresql://USER:PASSWORD@HOST:5432/postgresDATABASE_ADAPTER 可以不设置,默认为 postgres。
创建管理员
SUPER_ADMIN_EMAIL=you@example.com SUPER_ADMIN_PASSWORD='<password>' pnpm db:bootstrap-super-admin凭据只留在服务端
不要把连接串或 Supabase service-role 密钥暴露给客户端代码。Supabase 的 Data API 若已暴露这些表,需限制角色授权,并对暴露表启用及审查行级安全策略。本项目的服务端权限不会自动保护该 API。
使用托管 Postgres
Supabase 和 Neon 使用同一套 Postgres 适配器与迁移链。迁移优先用直连,运行期使用上文选定的连接方式;应用不需要服务商 SDK。修改 schema 时,Postgres 与 SQLite 两条迁移链都要添加对应迁移。
生产环境里连接从哪里来
部署如何连上 Postgres,取决于 deploy.config.json 里记录的平台。上面的步骤适用于本地使用和在检出目录里迁移;生产环境里连接这样提供:
| 平台 | 应用如何连接 | schema 如何迁移 |
|---|---|---|
| Cloudflare | 经 Hyperdrive:DATABASE_ADAPTER=hyperdrive,加上 wrangler.jsonc 里的 HYPERDRIVE 绑定。Worker 不持有 DATABASE_URL | 在检出目录里把 DATABASE_URL 设为 Postgres URL,执行 pnpm db:migrate |
| Fly.io | DATABASE_URL 作为应用密钥 | 每次部署时的 release_command |
| Railway | .railway/railway.ts 里声明的 Postgres,它的 DATABASE_URL 会传给各个服务 | web 服务的 pre-deploy 步骤 |
| Docker | compose 自带的 postgres 服务,POSTGRES_PASSWORD 来自 .env.production | compose 的 migrate 服务 |
在 Workers 上,Postgres 客户端只存活一个请求,连接池由它背后的 Hyperdrive 负责。见部署到 Cloudflare Workers、部署到 Fly.io、部署到 Railway和用 Docker Compose 部署。
验证
pnpm validate:db-adapters然后启动应用,以管理员身份登录并打开 /admin。
常见问题
出现 DATABASE_URL is required when DATABASE_ADAPTER=postgres
连接串为空。设置 DATABASE_URL。
pnpm db:migrate 报告已有 schema
数据库中存在不是由迁移链创建的表。删库重建后再运行 pnpm db:migrate。
需要运行 pnpm db:generate 吗?
不需要。generate 用于为 schema 变更写出新迁移,并不用于准备数据库。
参考
- 环境变量
- 部署模型
- Postgres.js:这个适配器加载的驱动
- Supabase 连接串