NextJS SSR中Axios请求Django HttpOnly Cookie认证接口报401错误
问题原因与修复方案
核心运行环境错配
你在getServerSideProps中写的axios请求,实际运行在NextJS的Node.js服务端进程中,而非用户的浏览器环境。
HttpOnly Cookie的存储位置是用户的浏览器本地,只有浏览器发起请求时才会自动携带对应域的Cookie;Node.js服务端发起的请求完全无法读取用户浏览器存储的Cookie,因此请求头中Cookie字段为空,Django端识别不到身份就会返回401。
Postman能正常调用接口,是因为它是独立客户端,会维护一套独立的本地Cookie存储,和浏览器的Cookie机制完全隔离,不受这个运行环境差异的限制。
如果要在getServerSideProps中正常调用需要认证的Django接口,需要手动把用户请求携带的Cookie提取出来,转发给发往Django的请求,参考写法:
export async function getServerSideProps(context) { const apiUrl = 'http://127.0.0.1:8000/api/auth/profile/'; // 从入站请求中提取用户携带的Cookie const userCookie = context.req.headers.cookie || ''; const resp = await axios.get(apiUrl, { headers: { 'Content-Type': 'application/json', // 把提取到的Cookie附到发往Django的请求头中 'Cookie': userCookie } }) // axios会自动解析返回的JSON,直接从data字段取数据即可 const profileData = resp.data; console.log(profileData) return { props: {} }; }
现有代码的语法错误
原代码存在两处不生效的写法:
- 错误传参:写了
axios.get(url, Headers=headers),这不是合法的JS传参逻辑。axios的第二个参数是请求配置对象,需要写成axios.get(url, { headers: headers }),大写的Headers字段不会被axios识别,配置完全失效。 - 错误取返回值:把axios的返回值当成fetch的Response对象使用,
resp.json是fetch提供的JSON解析方法,axios默认会自动完成返回体解析,取数据要使用resp.data。
跨域场景的Cookie携带规则校验
如果后续把请求迁移到浏览器端执行,跨域场景(Django跑在8000端口、NextJS跑在3000端口,属于跨域)下还需要满足几个硬性规则,否则浏览器依然不会主动携带Cookie:
- 浏览器端axios请求必须开启
withCredentials: true配置,否则默认不会在跨域请求中附带Cookie。 - Django端CORS配置需要开启
CORS_ALLOW_CREDENTIALS = True,且CORS_ALLOWED_ORIGINS不能使用通配符*,需要明确配置你的NextJS服务地址,否则浏览器会拦截带Cookie的跨域响应。 - Django设置的认证Cookie需要将
SameSite属性配置为None并开启Secure标记(本地开发可临时将SameSite设为Lax调试),否则现代浏览器会默认拦截跨站场景下的第三方Cookie发送。
内容的提问来源于stack exchange,提问作者forest
相关产品推荐
相关产品推荐

