You need to enable JavaScript to run this app. 如何将create-react-app开发环境对接Django后端 无需每次执行build命令
优惠活动
大模型
产品
解决方案
定价
更多

如何将create-react-app开发环境对接Django后端 无需每次执行build命令

Django对接React开发环境免打包调试方案

核心思路

放弃开发阶段将React打包产物托管给Django的模式,同时启动React自带的热更新开发服务(默认端口3000)与Django后端服务(默认端口8000),根据你的业务场景选择以下两种适配方案即可,开发全程无需执行npm run build。


方案1:前后端完全分离调试(推荐)

适合绝大多数前后端分离项目,开发体验最优

  • 安装Django跨域依赖
    执行命令:pip install django-cors-headers
  • 修改Django settings.py 配置跨域规则
    INSTALLED_APPS = [
        # 原有其他应用不变
        'corsheaders',
    ]
    
    MIDDLEWARE = [
        # 放在中间件列表最顶部
        'corsheaders.middleware.CorsMiddleware',
        'django.middleware.common.CommonMiddleware',
        # 原有其他中间件不变
    ]
    
    # 开发环境仅允许React开发服务的跨域请求
    CORS_ALLOWED_ORIGINS = [
        "http://localhost:3000",
        "http://127.0.0.1:3000",
    ]
    
  • 配置React接口代理
    直接在React项目的package.json中新增一行配置即可:"proxy": "http://127.0.0.1:8000"
    所有React侧发起的接口请求会自动转发到Django服务,无需修改原有接口路径。
  • 启动服务
    两个终端分别执行命令:
    • Django侧:python manage.py runserver
    • React侧:npm start
      开发时直接访问http://localhost:3000即可,React热更新实时生效,接口可正常调用Django后端。

方案2:Django托管入口HTML场景适配

如果你的项目需要Django渲染入口HTML(比如注入模板变量、服务端控制登录态等),可以用该方案适配你现有的项目结构

  • 给React开发服务配置跨域资源头
    修改React项目package.json的启动命令,添加跨域允许配置:
    // Mac/Linux环境配置
    "start": "BROWSER=none HEADERS='{\"Access-Control-Allow-Origin\": \"*\"}' react-scripts start"
    // Windows环境需要先安装cross-env:npm i cross-env -D,再配置为
    "start": "cross-env BROWSER=none HEADERS='{\"Access-Control-Allow-Origin\": \"*\"}' react-scripts start"
    
  • 修改Django入口模板的静态资源引用路径
    把原模板中引用build目录静态资源的路径替换为React开发服务的地址:
    <!-- 开发环境使用该配置,上线时切回原有build目录相对路径即可 -->
    <script src="http://localhost:3000/static/js/bundle.js"></script>
    <link rel="stylesheet" href="http://localhost:3000/static/css/main.css">
    
    也可以在Django中通过DEBUG配置自动切换资源前缀,无需手动修改模板。
  • 启动服务
    同样分别启动Django和React开发服务,访问http://localhost:8000即可正常使用,React热更新能力不受影响。

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

相关产品推荐
方舟 Agent Plan

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

最近更新时间:2026.10.17 01:36:08