You need to enable JavaScript to run this app. NextJS SSR中Axios请求Django HttpOnly Cookie认证接口报401错误
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.30 17:27:05