Better Auth 与 Fastify 集成指南

本指南提供了配置基本处理程序和 CORS 设置的逐步说明。

在继续之前，您需要先配置好 Better Auth 实例。如果尚未设置，请查阅我们的安装指南。

前提条件

在集成之前，请确认满足以下要求：

Node.js 环境：安装了 v16 或更高版本
ES 模块支持：启用 ES 模块方式，通过以下任一途径：
- package.json 中设置 { "type": "module" }
- TypeScript 的 tsconfig.json 中设置 { "module": "ESNext" }
Fastify 依赖：
npm install fastify @fastify/cors

对于 TypeScript 使用者：请确保 tsconfig.json 中包含 "esModuleInterop": true，以获得最佳兼容性。

认证处理程序设置

通过创建一个通配路由来配置 Better Auth 处理身份验证请求：

server.ts

import Fastify from "fastify";
import { auth } from "./auth"; // 您配置的 Better Auth 实例

const fastify = Fastify({ logger: true });

// 注册认证端点
fastify.route({
  method: ["GET", "POST"],
  url: "/api/auth/*",
  async handler(request, reply) {
    try {
      // 构造请求 URL
      const url = new URL(request.url, `http://${request.headers.host}`);
      
      // 将 Fastify 的 headers 转换为标准 Headers 对象
      const headers = new Headers();
      Object.entries(request.headers).forEach(([key, value]) => {
        if (value) headers.append(key, value.toString());
      });

      // 创建兼容 Fetch API 的请求对象
      const req = new Request(url.toString(), {
        method: request.method,
        headers,
        ...(request.body ? { body: JSON.stringify(request.body) } : {}),
      });

      // 处理身份验证请求
      const response = await auth.handler(req);

      // 将响应转发给客户端
      reply.status(response.status);
      response.headers.forEach((value, key) => reply.header(key, value));
      reply.send(response.body ? await response.text() : null);

    } catch (error) {
      fastify.log.error("认证错误：", error);
      reply.status(500).send({ 
        error: "内部认证错误",
        code: "AUTH_FAILURE"
      });
    }
  }
});

// 启动服务器
fastify.listen({ port: 4000 }, (err) => {
  if (err) {
    fastify.log.error(err);
    process.exit(1);
  }
  console.log("服务器运行在 4000 端口");
});

受信任的来源

当请求来自不同来源时，默认会被阻止。您可以向 auth 实例添加受信任来源。

export const auth = betterAuth({
  trustedOrigins: ["http://localhost:3000", "https://example.com"],
});

配置 CORS

通过正确配置 CORS 来保护您的 API 端点：

import fastifyCors from "@fastify/cors";

// 配置 CORS 策略
fastify.register(fastifyCors, {
  origin: process.env.CLIENT_ORIGIN || "http://localhost:3000",
  methods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
  allowedHeaders: [
    "Content-Type",
    "Authorization",
    "X-Requested-With"
  ],
  credentials: true,
  maxAge: 86400
});

// 在注册 CORS 后挂载认证处理程序
// （使用前面所示的处理程序配置）

在生产环境中，请始终限制 CORS 来源。使用环境变量实现动态配置。

获取用户会话

在您的 Fastify 路由中获取用户会话，请使用 auth.api.getSession 方法。Better Auth 提供了 fromNodeHeaders 辅助函数，用于将 Node.js 请求头转换为 Better Auth 期望的格式。