You need to enable JavaScript to run this app. Next.js+Express.js集成csurf:首次POST报invalid csrf token、刷新后正常排查
优惠活动
大模型
产品
解决方案
定价
更多

Next.js+Express.js集成csurf:首次POST报invalid csrf token、刷新后正常排查

问题根因

你的报错本质是CSRF校验时,请求头携带的token和Cookie中存储的secret不匹配,触发原因有三个核心点:

  1. 中间件挂载逻辑不合理
    当前代码把csurfProtection全局挂载到Express实例上,意味着所有请求(包括Next.js的页面渲染请求、静态资源请求)都会经过CSRF防护逻辑。而csurf的Cookie模式下,所有经过中间件的GET安全请求,都会自动初始化、轮换CSRF secret并通过Set-Cookie返回给浏览器,这个过程不需要手动调用req.csrfToken()。
  2. 异步时序错位
    首次页面加载时,浏览器没有任何_csrfCookie,SSR处理页面GET请求的流程会先生成第一版secret,写入响应头返回给浏览器。等页面hydration完成后,前端在useEffect里异步请求/api/csrfToken,这个接口被调用时会再次生成第二版secret、覆盖原有Cookie并返回对应token。因为整个拉取token的流程是异步的,首次发起POST请求时,极容易出现「请求头里的token对应旧secret,但Cookie里已经是新secret」的不匹配窗口,直接触发Invalid token报错。
  3. 错误处理中间件位置错误
    你把四参数的通用错误处理中间件放在了csurf防护逻辑的前面,导致csurf抛出的原始错误没有被统一捕获,排障时无法看到完整的错误上下文,进一步放大了问题的排查难度。

而刷新页面后流程能跑通,是因为浏览器已经缓存了上一次请求生成的secret,整个流程的secret生成、token返回、请求校验的时序已经完全对齐,不会再出现不匹配的问题。

针对性解决方法
  • 调整通用错误中间件的位置:把四参数错误处理逻辑挪到所有路由(包含/api路由、Next.js的catchall页面路由)的最后面,确保能捕获全链路的错误信息。
  • 缩小CSRF防护的作用范围:不要把csurfProtection全局挂载,只对/api下的接口应用防护,Next.js的页面、静态资源请求不需要经过CSRF校验逻辑,避免SSR流程和客户端接口流程生成多版本secret互相覆盖Cookie的问题。
    // 调整后的server.js核心逻辑示例
    nextApp.prepare().then(() => {
      const app = express();
      app.use(bodyParser.json());
      app.use(bodyParser.urlencoded({ extended: false }));
      app.use(cors());
      app.use(cookieParser());
      // 只对/api路由应用CSRF防护,不再全局挂载
      app.use('/api', csrfProtection, routes);
      // 错误处理中间件放在所有路由最后
      app.use((err, req, res, next) => {
        if (err.code === 'EBADCSRFTOKEN') {
          return res.status(403).json({ error: 'Invalid csrf token' });
        }
        res.status(500).send("Something went wrong!");
      });
      // Next.js的页面请求不经过CSRF防护
      app.get("*", (req, res) => handle(req, res));
      app.listen(port, (err) => {
        if (err) throw err;
        console.log(`listening on port ${port}`);
      });
    });
    
  • 消除异步时序差:不要在客户端挂载后异步拉取CSRF token,改为在SSR渲染页面时,通过getServerSideProps调用req.csrfToken(),把生成的token直接注入到页面组件的props里,前端初始化时直接从props读取token设置到axios默认请求头,避免异步请求带来的时序错位。
  • 修正前端请求路径:把当前相对路径'api/csrfToken'调整为绝对路径'/api/csrfToken',避免非根路径下的请求路由错误。

补充:csurf包已经停止维护,生产环境建议切换到官方推荐的替代库,避免后续安全漏洞。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.07 17:36:03