Heroku通过GitHub部署Django+React网站执行collectstatic报错如何解决

核心报错原因 #

本次部署失败的根本原因是Django项目未配置STATIC_ROOT参数，导致Heroku自动执行静态文件收集步骤时触发配置错误。

具体修复步骤 #

• 第一步：补全Django静态文件配置 #

  打开Django项目的settings.py文件，在文件末尾添加如下配置：

  import os
  # 静态文件收集的输出目录，Heroku部署必须配置该参数
  STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')
  # 若已有STATIC_URL配置无需重复添加
  STATIC_URL = '/static/'
  # 配置额外静态文件查找路径，可根据你前端打包后资源的存放位置调整
  STATICFILES_DIRS = [
      os.path.join(BASE_DIR, 'static'),
      # 若React打包后的资源放在build目录，可加如下路径
      # os.path.join(BASE_DIR, 'build'),
  ]
  

• 第二步：调整Heroku buildpack顺序 #

  Heroku检测到你项目同时包含Python和Node.js依赖，默认优先使用Python buildpack会导致React前端未打包就部署，可手动调整buildpack顺序：

  # 优先级1先执行Node.js buildpack打包前端资源
  heroku buildpacks:add --index 1 heroku/nodejs
  # 优先级2执行Python buildpack部署Django后端
  heroku buildpacks:add --index 2 heroku/python
  

• 第三步：临时规避方案 #

  若你暂时不需要在部署阶段收集静态文件，可先执行如下命令禁用该步骤，快速完成部署后再排查细节配置：

  heroku config:set DISABLE_COLLECTSTATIC=1
  

完成上述修改后，将代码推送至GitHub重新触发Heroku部署即可。

内容的提问来源于stack exchange，提问作者ana are mere