You need to enable JavaScript to run this app. Next.js 开发中出现 /api/me 与 /api/feed 接口响应内容混淆问题
优惠活动
大模型
产品
解决方案
定价
更多

Next.js 开发中出现 /api/me 与 /api/feed 接口响应内容混淆问题

提问背景

开发首个Next.js应用时,遇到随机的接口响应混淆问题。页面首次加载完成后会自动发起两个请求:/api/me 和 /api/feed。
组件端的数据获取逻辑如下:

useEffect(() => {
  async function loadData() {
    const res = await fetch('/api/me');
    try {
      const body = await res.json();
      if (body.error) {
        return router.push('/login');
      }
      setUser(body.user);
    } catch (e) {
      router.push('/login');
    }
  }
  loadData();
}, []);

useEffect(() => {
  async function loadFeed() {
    const res = await fetch('/api/feed');
    const body = await res.json();
    console.log('fetch', body.data);
    setFeed(body.data);
  }

  if (user) {
    loadFeed();
  }
}, [user]);

故障表现

页面重载时随机出现响应内容混淆:

  • /api/feed 正常应返回数组格式的Feed数据
  • /api/me 正常应返回用户对象
  • 异常状态下,重载时偶尔会出现两个请求都收到/api/me返回的对象,或都收到/api/feed返回的数组,仅少数场景能正常匹配对应接口的返回内容。
    排查过程未找到其他开发者反馈同类问题,判断为自身代码存在逻辑错误。

现有服务端实现

  • Feed接口 /pages/feed/api.js:
import handler from '../../helpers/routes/handler';
import auth from '../../middlewares/auth';
import * as feedController from '../../controllers/feed';

export default handler
  .use(auth)
  .get((req, res) => feedController.get(req, res));
  • 公共路由处理器 handler.js:
import nextConnect from 'next-connect';
import { getSession } from '../../config/passport/encrypt';

const handler = nextConnect()
  .use(async (req, res, next) => {
    const session = await getSession(req);

    if (!session) {
      return next();
    }
    next();
  });

export default handler;
  • Feed接口控制器 controllers/feed.js:
import * as expertMarketerService from '../services/expert_marketer';

// eslint-disable-next-line import/prefer-default-export
export const get = async (req, res) => {
  const data = await expertMarketerService.get(req.user);
  return res.status(200).send({ data });
};
  • 用户信息接口 pages/api/me.js:
import handler from '../../helpers/routes/handler';
import auth from '../../middlewares/auth';

export default handler
  .use(auth)
  .get((req, res) => res.status(200).send({ user: req.user }));

问题根因

公共路由处理器导出的是全局共享的nextConnect单例,被多个API路由复用挂载中间件和请求处理器,最终导致不同路由的逻辑互相污染、响应串扰。

问题逻辑链路

  • Next.js的所有API路由都运行在同一个Node.js进程下,所有Node模块只会在进程启动时被加载一次
  • 原实现中的handler.js在模块加载阶段就调用nextConnect()创建了唯一的处理器实例,直接通过导出语句暴露给所有路由
  • /api/me 和 /pages/feed/api.js 都导入了这个同一个全局实例,在各自的模块加载阶段就链式调用.use(auth)、.get(...),给这个全局实例追加自己的路由逻辑
  • 最终这个全局单例上同时挂载了两个API路由的中间件和get方法,next-connect处理请求时无法正确匹配路由来源,会随机将请求路由到当前实例上匹配到的第一个get处理器,就出现了两个接口返回内容混淆的问题。

修复方案

将公共处理器的创建逻辑改为工厂函数,每个API路由初始化时生成独立的处理器实例,从根源上避免全局单例的逻辑污染。

  1. 修改公共处理器文件 handler.js,移除模块顶层的单例创建逻辑,导出可生成新实例的工厂函数:
import nextConnect from 'next-connect';
import { getSession } from '../../config/passport/encrypt';

// 导出工厂函数,每次调用生成独立的处理器实例
export default function createHandler() {
  return nextConnect()
    .use(async (req, res, next) => {
      const session = await getSession(req);
      if (!session) {
        return next();
      }
      next();
    });
}
  1. 修改 /api/me 路由的导入和初始化逻辑,每次导出路由时创建独立处理器:
import createHandler from '../../helpers/routes/handler';
import auth from '../../middlewares/auth';

export default createHandler()
  .use(auth)
  .get((req, res) => res.status(200).send({ user: req.user }));
  1. 修改 /pages/feed/api.js 路由的导入和初始化逻辑,同样使用独立处理器实例:
import createHandler from '../../helpers/routes/handler';
import auth from '../../middlewares/auth';
import * as feedController from '../../controllers/feed';

export default createHandler()
  .use(auth)
  .get((req, res) => feedController.get(req, res));

注意事项

  • 不要在模块顶层直接创建并导出nextConnect实例供多路由复用
  • 每个API路由必须绑定独立的nextConnect处理器实例,避免中间件、路由处理方法的互相挂载污染

内容的提问来源于stack exchange,提问作者iagowp

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 21:45:05