You need to enable JavaScript to run this app. 本地开发中React与django-rest-framework跨源CSRF同源实现方案
优惠活动
大模型
产品
解决方案
定价
更多

本地开发中React与django-rest-framework跨源CSRF同源实现方案

跨端口开发场景下DRF与React的CSRF问题通用处理方案

通用处理逻辑

这类问题的核心成因是:本地开发时前后端分别运行在localhost:3000和localhost:8000,虽然主机名相同,但端口差异导致属于不同源,触发两类CSRF链路断裂:

  1. 跨源场景下DRF默认的CORS策略会拦截前端请求,不允许后端返回的CSRF Cookie被前端JS读取
  2. 浏览器默认的Cookie发送规则,会阻断跨端口请求携带的CSRF Cookie,导致后端无法完成令牌校验

通用解决思路分为两类:

  • 跨源链路适配:不修改请求路径,直接打通跨源下的CSRF令牌传递逻辑
    • 后端配置CORS规则:开启CORS_ALLOW_CREDENTIALS = True,将前端运行的http://localhost:3000加入允许的源列表,允许前端携带凭证发起跨源请求
    • 后端调整CSRF Cookie开发环境配置:将CSRF_COOKIE_SAMESITE设置为Lax,避免默认Strict规则下跨端口的Cookie被浏览器拦截;开发环境下保持CSRF_COOKIE_HTTPONLY为默认的False,允许前端JS读取Cookie中的令牌值
    • 前端适配:在所有请求拦截器中,从Cookie中读取csrftoken值,统一写入写操作(POST/PUT/DELETE等)的X-CSRFToken请求头
  • 同源模拟:通过请求转发完全对齐生产环境的同源请求行为,消除跨源适配的额外成本

本地开发环境实现“同源”的具体配置

有两种零额外适配成本的常用方案,可以完全模拟生产环境的同源效果,避免开发/生产环境的逻辑偏差:

  • 利用前端开发服务器内置代理实现同源转发
    • React开发服务器(CRA、Vite等主流脚手架)均内置了本地代理能力:保持前端运行在localhost:3000,将所有API类请求(通常以/api、/auth开头的路径)由开发服务器转发到本地8000端口的DRF服务
    • 这种模式下,浏览器发出的所有请求的源都是http://localhost:3000,和生产环境的同源行为完全一致:后端种下的CSRF Cookie会被浏览器自动携带,前端只需要沿用生产环境的请求拦截逻辑读取CSRF令牌即可,不需要修改任何跨源相关配置
    • 配置示例:
      • CRA搭建的项目可在package.json中直接添加配置:"proxy": "http://localhost:8000"
      • Vite搭建的项目可在vite.config.js中配置server.proxy规则,将指定API路径的请求代理转发到8000端口
  • 本地反向代理统一入口
    • 通过本地hosts文件,将生产使用的域名mydomain.awesome映射到本地回环地址127.0.0.1
    • 本地启动轻量反向代理服务,将该域名下的前端静态资源请求转发到3000端口的React开发服务,将API路径的请求转发到8000端口的DRF服务
    • 这种模式下可以直接复用生产环境的所有域名、CSRF、CORS配置,完全消除开发环境的特殊配置项

开发注意:所有为了打通本地CSRF链路调整的特殊配置,仅保留在开发环境的settings配置中,生产环境需恢复DRF默认的严格CSRF防护规则,避免引入安全风险。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.11.03 00:36:04