SuperAPI AI 工具集

neon-vercel-postgres

数据与分析

查看项目

更新于 10-16 03:14

技能介绍

用途:在 Cloudflare Workers、Vercel Edge、Next.js 等无服务器/边缘环境中接入 Neon 或 Vercel Postgres(两者后端同为 Neon),完成建库、建表、查询、事务与部署。资料标注为 Production Ready,依赖 None,提及版本:@neondatabase/serverless@1.0.2、@vercel/postgres@0.10.0、drizzle-orm@0.44.7、neonctl@2.16.1。

主要能力:两条路径——Neon 直连(多云、Cloudflare Workers,可访问 branching API)与 Vercel Postgres(Vercel 零配置,自动注入环境变量)。二者均基于 HTTP/WebSocket,无需 TCP,适合无服务器;使用池化连接串时自动连接池;支持事务、Drizzle ORM(边缘兼容)与 Prisma(需 Node.js 运行时);支持用 Neon branching 做预览环境。

必要用法:安装 npm install @neondatabase/serverless 或 npm install @vercel/postgres;可用 Neon CLI(npm install -g neonctl,neonctl auth,neonctl projects create --name my-app,neonctl connection-string main);Vercel 侧用 vercel postgres create 与 vercel env pull .env.local。连接串必须用池化格式(主机名含 -pooler.)并加 ?sslmode=require;查询必须用模板标签 sql... 防注入,勿拼接字符串;Vercel 手动事务需 try/finally 中 client.release();迁移在 Node.js 环境执行,勿在边缘函数中运行;连接串放环境变量,勿提交 .env。

适用场景:边缘/无服务器 API、Next.js Server Actions 与 API Routes、Cloudflare Workers 配合 wrangler 部署。

限制与已知问题:免费额度 100 并发连接;非池化连接易出现连接池耗尽;边缘不支持 TCP,故不能用 pg / postgres.js;Prisma 不能在 Cloudflare Workers 使用(改用 Drizzle);边缘函数事务易超时(通常 30s,建议事务 <5s);存在环境变量命名易错、缺 sslmode、SSL 配置、连接泄漏、删除分支后旧连接失效、Neon API 鉴权缺失等问题。原文列举的 15 项问题中,最后一项内容未提供完整,此处不展开。