用途:Neon Functions 面向请求/响应型后端工作负载,尤其是需要长时间存活、贴近数据库的场景,如智能体 HTTP 流、图像/视频生成、WebSocket 或 SSE 服务、Webhook 与机器人、响应后的异步处理,以及按 cron 或对象存储上传触发的周期任务。
主要能力:函数是带 fetch(request) 方法的默认导出(兼容 Workers/WinterTC,Hono 应用可直接导出),运行在 Node.js 24,可用全部 Node API;每个函数获得公开 HTTPS URL,与分支数据库同区运行,分支有 Postgres 时自动注入 DATABASE_URL;支持函数触发器(type: "schedule" 或 "storage_object_created");每个分支独立部署、独立 URL、独立状态,部署到子分支不影响父分支;空闲时仍可缩容到零。
使用方式:在 neon.ts 中通过 @neon/config 的 defineConfig 声明 functions(以 slug 为键,slug 为永久标识,首字母小写、1-20 位字母数字、不含连字符);本地用 neon dev 热重载并注入环境变量,部署用 neon deploy --env <file>,单函数部署用 neon functions deploy <slug> --src src/index.ts,获取 URL 用 neon functions get <slug>(invocation_url),列表与删除用 neon functions list|get|delete;基础设施即代码命令包括 neon config status、neon config plan、neon config apply。
适用场景:可添加到 Vercel/Netlify 等全栈应用作为贴近数据的 Hono API 层,也可让纯客户端 SPA 直接调用函数承载整个后端控制面;查询 Postgres 建议优先用函数或既有框架处理器,而非 Data API。
限制:目前仅在美国东部(aws-us-east-2、aws-us-east-1)、欧洲中部(aws-eu-central-1)和亚太东南(aws-ap-southeast-1)可用;纯静态站点或不在此区域的负载不适用;需在首字节 15 分钟内开始响应;涉及原生二进制或自定义构建时需额外打包配置(如 externalPackages、bundler)。