Workers 核心

这一课你将能做到

1. 编写完整的 Worker Fetch Handler，处理 GET/POST、JSON、Header、Query 参数
2. 用 Hono 或原生 Fetch API 实现路由、中间件、错误处理
3. 解释 Workers 的 Request / Response / ExecutionContext 生命周期

为什么要学

Worker 的核心就是一个 fetch(request, env, ctx) 函数。听起来简单，但里面的门道很多：请求体怎么解析？大文件怎么流式传输？怎么同时转发到多个后端？怎么加鉴权中间件？

人话：Workers 核心就是「如何用标准 Web API 优雅地处理 HTTP 请求」。学会了这套，不管是写 API 网关、做请求聚合、还是做边缘鉴权，都游刃有余。

先建立图像

用户请求 ──> [Cloudflare Edge Node]
                     │
                     ▼
              Worker.fetch(request, env, ctx)
                     │
         ┌───────────┼───────────┐
         ▼           ▼           ▼
    [读取请求]   [业务逻辑]   [访问绑定]
         │           │           │
         ▼           ▼           ▼
    [返回 Response]              [KV/R2/D1/Queue]
                     │
                     ▼
              用户收到响应

ctx（ExecutionContext）是 Workers 特有的：它提供 waitUntil() 和 passThroughOnException()，让你在返回响应后还能继续异步执行（比如写日志、发统计）。

跟着做

步骤 1：最基础的 Fetch Handler

export default {
  async fetch(request: Request, env: Env, ctx: ExecutionContext): Promise<Response> {
    const url = new URL(request.url);
    
    if (url.pathname === '/') {
      return new Response('Hello Edge!');
    }
    
    if (url.pathname === '/api/user') {
      return Response.json({ id: 1, name: 'Alice' });
    }
    
    return new Response('Not Found', { status: 404 });
  },
} satisfies ExportedHandler<Env>;

步骤 2：解析 Query、Header、Body

export default {
  async fetch(request: Request): Promise<Response> {
    const url = new URL(request.url);
    const q = url.searchParams.get('q');
    const auth = request.headers.get('Authorization');
    
    if (request.method === 'POST') {
      const contentType = request.headers.get('content-type') ?? '';
      
      if (contentType.includes('application/json')) {
        const body = await request.json();
        return Response.json({ received: body });
      }
      
      if (contentType.includes('application/x-www-form-urlencoded')) {
        const formData = await request.formData();
        const name = formData.get('name');
        return Response.json({ name });
      }
    }
    
    return Response.json({ q, auth });
  },
} satisfies ExportedHandler<Env>;