在 Node.js 中使用 Fastify 构建文档完善且经过认证的 API
内容提要
Heroku 提供灵活的 AI PaaS 平台，简化应用程序的部署和扩展。开发者可以使用 Fastify 框架快速构建高效 API，支持 JWT 认证和 OpenAPI 规范，同时享受可靠的数据库服务，助力各行业的创新与增长。
延伸解读
Fastify 插件架构的模块化优势
Fastify 的插件架构让开发者可以将数据库连接、认证、路由等逻辑拆分为独立插件，并通过 @fastify/autoload 自动加载。这种设计降低了模块间的耦合，便于复用和测试。文中自定义的 db 插件和 auth 插件就是典型例子，它们分别封装了 Postgres 查询和 JWT 验证，再通过 decorate 挂载到 fastify 实例上，供路由直接调用。
JWT 认证在 Fastify 中的实现要点
文章使用 RSA256 非对称加密：私钥签名 JWT，公钥验证签名。公钥以 base64 形式存入环境变量 RSA_PUBLIC_KEY_BASE_64，由 @fastify/jwt 加载。受保护路由通过 onRequest 钩子调用 fastify.auth 和 verifyJWT 完成校验，验证后的 payload 会挂到 request.user 上，因此路由中可直接读取 request.user.username 来查询用户资料。
OpenAPI 规范与 Swagger UI 的自动生成
借助 @fastify/swagger 和 @fastify/swagger-ui，Fastify 能根据路由的 schema 定义自动生成完整的 OpenAPI 规范，并在 /api-docs 路径提供交互式 UI。文中为 /profile 路由定义了响应 schema 和安全方案，生成的规范还可导入 Postman 作为集合使用，方便测试和协作。这减少了手动维护 API 文档的成本。
从本地到 Heroku 的部署流程
文章演示了使用 Heroku CLI 快速部署：heroku create 创建应用，heroku addons:create heroku-postgresql 添加数据库，通过 heroku pg:psql 导入建表和种子数据，再用 heroku config:set 设置公钥环境变量，最后 git push heroku main 完成部署。整个过程只需几条命令，适合希望快速上线 API 的开发者。
Q&A
Fastify 框架的主要特点是什么？
Fastify 是一个高效的 Node.js Web 框架，具有插件架构，支持快速构建高效 API，提供良好的开发者体验。
如何在 Heroku 上部署使用 Fastify 构建的 API？
使用 Heroku CLI，可以通过简单的命令创建应用、配置数据库并部署 API，例如使用 'heroku create' 和 'git push heroku main'。
Fastify 如何支持 JWT 认证？
Fastify 通过 @fastify/jwt 插件支持 JWT 认证，允许开发者验证 JWT 签名并在请求中提取用户信息。
Heroku 提供哪些服务来支持 API 开发？
Heroku 提供灵活的 AI PaaS 平台、可靠的数据库服务以及支持多种编程语言的环境，简化应用程序的部署和扩展。
如何使用 Fastify 生成 OpenAPI 规范？
Fastify 通过其插件生态系统支持 OpenAPI，可以自动生成完整的 OpenAPI 规范并提供用户友好的 UI。
在 Fastify 中如何处理数据库查询？
在 Fastify 中，可以通过创建插件来处理数据库查询，例如使用 pg 模块连接 PostgreSQL 数据库并定义查询方法。
