You need to enable JavaScript to run this app. NextJS SSR下如何配置axios拦截器获取httpOnly cookie的access_token
优惠活动
大模型
产品
解决方案
定价
更多

NextJS SSR下如何配置axios拦截器获取httpOnly cookie的access_token

双端适配的axios拦截器实现方案

首先明确两个核心约束,避免走技术弯路:

  • httpOnly属性的cookie,浏览器端JS没有权限通过document.cookie读取,客户端场景下的凭证携带要依赖浏览器原生的cookie机制
  • Next.js服务端是常驻进程,所有用户请求共享同一个运行时上下文,绝对不能把单次请求的cookie存在全局变量里,否则会出现多用户token串号的安全问题

环境判断与token提取规则

双端的判断逻辑非常简单,不需要额外的三方依赖:

  • 客户端环境:判断条件为typeof document !== 'undefined',此时仅能读取非httpOnly的cookie字段
  • 服务端环境:判断条件为typeof window === 'undefined',此时无法直接获取用户请求的cookie,需要通过单次请求的配置透传当前请求对应的cookie串,再在拦截器内解析提取token

改造后的完整可用代码

import axios from 'axios';

// 通用token解析方法,双端环境都可以调用
function getToken(cookieStr = '') {
  // 匹配规则按实际的cookie字段名调整,示例假设token存在名为access_token的cookie中
  const tokenMatch = cookieStr.match(/(?:^|;\s*)access_token=([^;]*)/);
  return tokenMatch ? decodeURIComponent(tokenMatch[1]) : null;
}

// 初始化axios实例
const axiosInstance = axios.create({
  // 跨域请求时自动携带同域cookie,适配httpOnly凭证的场景
  withCredentials: true
});

// 请求拦截器配置
axiosInstance.interceptors.request.use(function (config) {
  let token;

  // 客户端场景:从浏览器cookie解析token(仅能拿到非httpOnly的字段)
  if (typeof document !== 'undefined') {
    token = getToken(document.cookie);
  }
  // 服务端场景:从请求配置透传的当前请求cookie中解析token
  else if (typeof window === 'undefined') {
    // 取调用时透传的原始cookie内容,避免全局状态串号
    const rawCookie = config._rawCookie || '';
    token = getToken(rawCookie);
  }

  // 仅当解析到有效token时才添加Bearer鉴权头,避免出现Bearer null的无效请求
  if (token) {
    config.headers.Authorization = `Bearer ${token}`;
  } else {
    delete config.headers.Authorization;
  }

  return config;
}, function (error) {
  return Promise.reject(error);
});

export default axiosInstance;

服务端场景的调用方式

在getServerSideProps这类服务端运行的代码中调用接口时,需要把当前请求上下文的cookie透传到axios配置中:

// 页面文件示例
export async function getServerSideProps({ req }) {
  // 调用接口时把当前请求的原始cookie传入自定义配置字段
  await axiosInstance.get('需要鉴权的接口地址', {
    _rawCookie: req.headers.cookie
  });

  return {
    props: {}
  }
}

常见踩坑说明

  • 原代码存在笔误:创建实例时定义的变量是_axios,后续挂载拦截器却使用了未定义的axiosInstance,直接运行会触发ReferenceError
  • 如果你的access_token是严格设置的httpOnly cookie,客户端场景下的getToken(document.cookie)永远读不到这个值,此时客户端请求的鉴权完全依赖withCredentials: true配置下浏览器自动携带cookie的机制,不需要手动拼接Authorization头
  • 不要尝试把Next.js的req对象直接挂到axios实例上做全局存储,多并发场景下必然会出现token串号问题,通过单次请求的config透传是目前最安全的实现方式

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.05 09:36:07