Neon Postgres 实践指南

要解决什么问题

在 Neon 这类 serverless Postgres 上跑应用时，常见矛盾是：运行时希望用连接池扛高并发，而 Prisma Migrate 等 DDL 又必须走能执行完整会话语义的直连。边缘或无服务器环境里，传统 TCP 长连接也不总是合适，需要区分 Prisma、Drizzle 各自的连接方式。

技能如何组织内容

技能按三条主线说明配置方式：

• Prisma：使用两个连接字符串——DATABASE_URL 给 Prisma Client 走池化端点，DIRECT_URL 给迁移走直连；池化侧通过 PgBouncer 支撑高并发连接。
• Drizzle：在边缘场景配合 Neon 的 Serverless Driver；neon-http 适合单次 HTTP 查询，neon-serverless（WebSocket）适合需要事务与会话的场景。
• 连接池：说明 Neon 内置 PgBouncer 的容量与预留连接（如为超级用户预留连接），并强调应用用池化、迁移用直连这一分工。

文末以「易踩的坑」表格形式归纳常见问题与严重度，便于对照官方文档排查。

适用边界与注意点

池化端点不能替代迁移所需的直连；连接池上限很高，但底层 Postgres 连接仍会被占用。若团队混用 ORM 与 serverless 运行时，需要按环境选对 driver，而不是共用一套「万能」连接串。