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路由初始化时生成独立的处理器实例,从根源上避免全局单例的逻辑污染。
- 修改公共处理器文件
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(); }); }
- 修改
/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 }));
- 修改
/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
相关产品推荐
相关产品推荐

