Next.js+Express.js集成csurf:首次POST报invalid csrf token、刷新后正常排查
问题根因
你的报错本质是CSRF校验时,请求头携带的token和Cookie中存储的secret不匹配,触发原因有三个核心点:
- 中间件挂载逻辑不合理
当前代码把csurfProtection全局挂载到Express实例上,意味着所有请求(包括Next.js的页面渲染请求、静态资源请求)都会经过CSRF防护逻辑。而csurf的Cookie模式下,所有经过中间件的GET安全请求,都会自动初始化、轮换CSRF secret并通过Set-Cookie返回给浏览器,这个过程不需要手动调用req.csrfToken()。 - 异步时序错位
首次页面加载时,浏览器没有任何_csrfCookie,SSR处理页面GET请求的流程会先生成第一版secret,写入响应头返回给浏览器。等页面hydration完成后,前端在useEffect里异步请求/api/csrfToken,这个接口被调用时会再次生成第二版secret、覆盖原有Cookie并返回对应token。因为整个拉取token的流程是异步的,首次发起POST请求时,极容易出现「请求头里的token对应旧secret,但Cookie里已经是新secret」的不匹配窗口,直接触发Invalid token报错。 - 错误处理中间件位置错误
你把四参数的通用错误处理中间件放在了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
相关产品推荐
相关产品推荐

