Next.js 13从/pages转/app目录时Iron Session适配问题求助

核心问题原因 #

1. 405 Method Not Allowed错误：前端发送的是POST请求，但后端仅导出了GET函数，请求方法不匹配；同时withIronSessionApiRoute是Iron Session为Next.js Pages Router设计的高阶函数，完全不适用于App Router的API路由写法。
2. Iron Session适配问题：目前Iron Session的官方高阶函数暂未完全适配Next.js 13 App Router，直接沿用Pages Router的写法会导致会话逻辑失效。

解决方案一：Iron Session临时适配App Router #

放弃使用withIronSessionApiRoute，改用Iron Session提供的getIronSession方法手动处理会话，配合App Router的cookies()和headers()API实现功能：

import { getIronSession } from "iron-session";
import { plaidClient, sessionOptions } from "@/lib/plaid";
import { cookies, headers } from "next/headers";
import { NextResponse } from "next/server";

// 注意：前端发送的是POST请求，这里要导出POST函数
export async function POST(request: Request) {
  // 解析请求体中的public_token
  const { public_token } = await request.json();

  // 初始化Iron Session
  const session = await getIronSession(cookies(), headers(), sessionOptions);

  // 调用Plaid接口交换token
  const exchangeResponse = await plaidClient.itemPublicTokenExchange({
    public_token,
  });

  // 将access_token存入会话并保存
  session.access_token = exchangeResponse.data.access_token;
  await session.save();

  return NextResponse.json({ ok: true });
}

关键说明 #

• 用getIronSession替代高阶函数，直接对接App Router的cookie和header工具；
• 必须导出与前端请求方法匹配的函数（这里是POST，因为需要接收请求体数据）；
• 会话保存后，Iron Session会自动处理cookie的加密与设置。

解决方案二：更换适配App Router的会话工具 #

如果不想在Iron Session的适配问题上消耗精力，可以选择以下成熟工具：

• Auth.js（原NextAuth.js）：Next.js官方推荐的认证方案，完全适配App Router，支持多种登录方式，内置安全的会话管理机制，可轻松存储自定义会话数据；
• Lucia：轻量级认证库，专注于会话管理与用户认证，体积小、灵活性高，完美支持App Router的API路由；
• 手动实现Cookie会话：通过Next.js的cookies()API，配合Node.js的crypto模块加密存储会话数据，适合简单场景，无需依赖第三方库。

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