Next.js 14对接FastAPI外部API的架构选型与鉴权问题咨询

核心结论：优先直接在服务端组件调用FastAPI端点 #

完全没必要把所有FastAPI接口都映射到Next.js API路由，这确实是冗余操作——Next.js 14的服务端组件（Server Component）本身就支持在服务端直接调用外部API，省去了中间转发的环节，减少维护成本和潜在的性能损耗。

服务端组件调用FastAPI时的Cookie传递问题解决 #

在服务端组件中，你需要手动从当前请求的headers里提取Cookie，然后在调用FastAPI时将其传入请求头，具体实现如下：

// 服务端组件示例
import { headers } from 'next/headers';

async function fetchFastAPIData() {
  const headerList = headers();
  const cookie = headerList.get('cookie'); // 获取当前请求的Cookie

  const response = await fetch('https://your-fastapi-domain/api/protected-endpoint', {
    method: 'GET',
    headers: {
      Cookie: cookie || '', // 把Cookie传给FastAPI
      // 可添加其他必要请求头
    }
  });

  if (!response.ok) {
    throw new Error('Failed to fetch data from FastAPI');
  }

  return response.json();
}

export default async function ServerPage() {
  const data = await fetchFastAPIData();
  return <div>{JSON.stringify(data)}</div>;
}

特殊场景下才需要映射Next.js API路由 #

只有当你需要在中间层做额外处理时，才考虑添加Next.js API路由作为转发层，比如：

• 需要对FastAPI的请求/响应做格式转换
• 需要在Next.js侧添加额外的权限校验逻辑
• 部分接口需要同时支持客户端和服务端调用，且客户端无法直接访问FastAPI（比如跨域限制）

内容的提问来源于stack exchange，提问作者freethrow