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
相关产品推荐
相关产品推荐

