Heroku部署Django遇staticfiles.W004错误及PostgreSQL表未创建求助

一、处理staticfiles.W004错误 #

1. 确认本地静态文件目录的Git提交状态 #

• 检查你的.gitignore文件，是否把static/目录添加到了忽略列表中。如果本地存在项目根目录下的static/文件夹（用于存放全局静态资源），但被Git忽略，推送到Heroku后该目录就不存在，会触发STATICFILES_DIRS指向不存在目录的错误。
• 若确实需要这个目录，从.gitignore中移除static/，然后执行：

  git add static/
  git commit -m "add static directory to repo"
  git push heroku main
  

2. 修正静态文件配置 #

保持以下标准配置（适配Heroku环境），不要随意修改STATIC_ROOT：

# settings.py
import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles')  # collectstatic的目标目录，Heroku依赖这个

# 仅当你有全局静态资源目录时才配置此项，且确保该目录存在并已提交Git
# STATICFILES_DIRS = [os.path.join(BASE_DIR, 'static')]

• 如果你没有全局静态目录，直接移除STATICFILES_DIRS配置即可，Django会自动扫描每个app下的static/子目录。

3. 确保Whitenoise配置正确 #

Heroku需要Whitenoise来服务静态文件，检查settings.py中的中间件配置：

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware',  # 必须放在SecurityMiddleware之后
    # 其他中间件...
]

# 可选：启用压缩和缓存
STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

二、处理数据库迁移显示应用但无表的问题 #

1. 验证数据库连接配置 #

• 执行以下命令查看Heroku的数据库URL：

  heroku config:get DATABASE_URL
  

• 确认settings.py中正确使用了该环境变量配置数据库：

  # settings.py
  import dj_database_url
  
  DATABASES = {
      'default': dj_database_url.config(conn_max_age=600, ssl_require=True)
  }
  

  （需确保已安装dj-database-url包，在requirements.txt中添加dj-database-url>=0.5.0）

2. 检查迁移文件的Git提交状态 #

• 本地每个app下的migrations/目录（除了__pycache__和.pyc文件）必须提交到Git，否则Heroku上没有迁移文件，无法生成表。
• 执行以下命令确认：

  git status
  

  若发现migrations目录未被追踪，执行：

  git add */migrations/*.py
  git commit -m "add migration files"
  git push heroku main
  

3. 重置迁移（适用于首次部署或迁移混乱的情况） #

如果迁移状态异常，可尝试重置：

1. 本地操作：删除每个app下migrations/目录中除__init__.py外的所有文件
2. 重新生成初始迁移：

   python manage.py makemigrations
   

3. 推送代码到Heroku：

   git add .
   git commit -m "reset migrations"
   git push heroku main
   

4. 在Heroku上执行迁移（使用--fake-initial避免重复初始化）：

   heroku run python manage.py migrate --fake-initial
   

4. 查看Heroku日志排查隐藏错误 #

执行以下命令实时查看日志，确认migrate过程中是否有未显示的错误：

heroku logs --tail

内容的提问来源于stack exchange，提问作者Design Point Jauharabad