用Hono构建超轻量API网关边缘计算时代的零依赖服务端方案API网关的重量问题传统API网关如Express、Fastify在边缘计算场景里有严重问题包体积大Express约5MBFastify约15MB——在Cloudflare Workers免费计划1MB限制里根本跑不了启动慢需要初始化中间件、加载路由——冷启动时间100ms内存占用高每个请求都要创建req/res对象——边缘计算按内存计费成本高Hono的优势超轻量核心包仅12KBgzipped零依赖不依赖任何第三方包多运行时支持Cloudflare Workers、Deno、Bun、Node.jsAPI友好类似Express的API但更简洁Hono核心API比Express简洁30%基本用法// Cloudflare Workers入口 import { Hono } from hono; const app new Hono(); // 路由定义和Express几乎一样 app.get(/api/health, (c) { return c.json({ status: ok, timestamp: Date.now() }); }); app.post(/api/users, async (c) { const body await c.req.json(); const user await createUser(body); return c.json(user, 201); }); app.get(/api/users/:id, (c) { const id c.req.param(id); const user await getUser(id); if (!user) return c.notFound(); return c.json(user); }); // 导出给Cloudflare Workers export default app;关键差异c.req.json()内置body解析不需要body-parser中间件c.json()直接返回JSON响应不需要res.json()c.notFound()内置404处理实战用Hono Cloudflare Workers构建全球API第一步初始化Hono项目# 用Hono官方模板支持多种运行时 npm create honolatest # 选择 # - Target: Cloudflare Workers # - Template: API # - TypeScript: Yes # - Package manager: npm cd my-api-gateway npm install项目结构my-api-gateway/ ├── src/ │ └── index.ts # Workers入口 ├── wrangler.toml # Cloudflare配置 ├── package.json └── tsconfig.json第二步实现API路由含中间件// src/index.ts import { Hono } from hono; import { cors } from hono/cors; import { logger } from hono/logger; import { jwt } from hono/jwt; // 创建Hono实例 const app new Hono(); // 全局中间件类似Express的app.use() app.use(*, cors({ origin: https://yourproduct.com })); app.use(*, logger()); // 公开路由不需要认证 app.get(/api/health, (c) { return c.json({ status: ok, region: c.env.REGION || unknown }); }); app.get(/api/public-posts, async (c) { // 从Cloudflare KV读取缓存的公开文章 const cacheKey public-posts; const cached await c.env.MY_KV.get(cacheKey); if (cached) { return c.json(JSON.parse(cached)); } const posts await fetchPostsFromDB(); // 调用外部API await c.env.MY_KV.put(cacheKey, JSON.stringify(posts), { expirationTtl: 300 }); // 缓存5分钟 return c.json(posts); }); // 需要认证的路由用JWT中间件 app.use(/api/*, jwt({ secret: c.env.JWT_SECRET })); app.get(/api/profile, async (c) { const payload c.get(jwtPayload); // 从JWT获取用户信息 const user await getUser(payload.sub); return c.json(user); }); app.post(/api/posts, async (c) { const user c.get(jwtPayload); const body await c.req.json(); const post await createPost({ ...body, authorId: user.sub, }); return c.json(post, 201); }); // 错误处理 app.onError((err, c) { console.error(API Error:, err); return c.json({ error: Internal Server Error }, 500); }); // 导出给Cloudflare Workers export default app;第三步配置Cloudflare Workers# wrangler.toml name my-api-gateway main src/index.ts compatibility_date 2024-07-01 # KV存储用于缓存 [[kv_namespaces]] binding MY_KV id your-kv-namespace-id # 环境变量通过wrangler secret设置 [vars] REGION global # 自定义域名可选 # routes [{ pattern api.yourproduct.com/*, zone_id ... }]设置环境变量# 设置JWT密钥不会暴露在代码里 wrangler secret put JWT_SECRET your-super-secret-key # 创建KV命名空间 wrangler kv:namespace create MY_KV第四步本地开发和测试# 启动本地开发服务器 npm run dev # 测试API curl http://localhost:8787/api/health # 输出{status:ok,region:unknown} # 部署到Cloudflare npm run deploy性能优化让Hono在边缘跑得更快优化一用Cloudflare KV做边缘缓存// 缓存策略按URL缓存GET请求 app.get(/api/posts/:id, async (c) { const postId c.req.param(id); const cacheKey post:${postId}; // 1. 尝试从KV读取缓存 const cached await c.env.MY_KV.get(cacheKey); if (cached) { c.header(X-Cache, HIT); return c.json(JSON.parse(cached)); } // 2. 缓存未命中查询数据库 c.header(X-Cache, MISS); const post await db.posts.findUnique({ where: { id: postId } }); if (!post) return c.notFound(); // 3. 写入缓存过期时间60秒 await c.env.MY_KV.put(cacheKey, JSON.stringify(post), { expirationTtl: 60 }); return c.json(post); });优化二用Cloudflare D1边缘数据库减少冷启动Cloudflare D1是边缘SQLite数据库——数据存储在离用户最近的Cloudflare节点。// 配置D1在wrangler.toml里 [[d1_databases]] binding DB database_name my-api-db database_id your-d1-database-id // 在代码里使用 app.get(/api/users/:id, async (c) { const userId c.req.param(id); // 查询D1边缘数据库延迟10ms const { results } await c.env.DB.prepare( SELECT * FROM users WHERE id ? ).bind(userId).all(); if (results.length 0) return c.notFound(); return c.json(results[0]); });优化三用Hono的c.executionCtx.waitUntil()处理后台任务app.post(/api/events, async (c) { const event await c.req.json(); // 立即返回响应不等待后台任务完成 c.executionCtx.waitUntil( // 后台任务发送邮件、写入数据库、调用第三方API Promise.all([ sendEmail(event), writeToDB(event), callWebhook(event), ]) ); return c.json({ success: true, message: Event received }, 202); });监控与调试Cloudflare Dashboard SentryCloudflare Dashboard提供请求量、错误率、响应时间分布按地区、设备、浏览器的细分实时日志流需要付费计划集成Sentry边缘版本import { Hono } from hono; import { sentry } from sentry/cloudflare; const app new Hono(); // 用Sentry包装Hono app export default sentry( (env) ({ dsn: env.SENTRY_DSN, environment: env.NODE_ENV, }), app );成本分析Hono Cloudflare vs 传统VPS场景每天100万次API请求方案月成本全球延迟(P95)运维成本VPSDigitalOcean $20/月$20200-500ms高需要自己监控、扩容AWS Lambda API Gateway$50-10050-150ms中需要配置Hono Cloudflare Workers$0-520ms低完全托管Cloudflare Workers免费计划每天10万次请求免费超出部分$0.50/百万次请求结论对独立开发者来说Hono Cloudflare Workers是成本最低、性能最好的API网关方案。结论Hono是边缘计算时代的最佳选择如果你的API需要全球低延迟、低成本、零运维Hono Cloudflare Workers是目前技术栈里性价比最高的组合。最小可行架构MVP用Hono写API路由10分钟上手用Cloudflare KV/D1做缓存和存储用wrangler deploy一键部署到全球200节点下一步把你的性能关键的API如/api/health、/api/public-*)迁移到Hono Cloudflare Workers——你会立即看到全球用户的API响应时间从500ms降到20ms。这是为账号19tanjinxi生成的第2607/0726/7篇技术博客主题Hono边缘计算API网关。
