collectstatic无法推送文件至S3，移除django_heroku导入后恢复正常

这问题我之前在部署Django到Heroku时碰到过，核心原因就是django_heroku库的自动配置会覆盖你原本设置的静态文件存储规则，强制把collectstatic的目标指向本地的staticfiles文件夹，而不是你配置的AWS S3存储桶。

为什么会出现这个差异？ #

当你注释掉import django_heroku时，Django会使用你手动配置的STATICFILES_STORAGE（指向S3的存储后端），所以collectstatic会提示要把文件推送到S3的目标位置；而当你导入并调用django_heroku.settings(locals())时，这个库会自动设置STATICFILES_STORAGE为本地的django.contrib.staticfiles.storage.StaticFilesStorage，同时把STATIC_ROOT设为staticfiles，导致文件都存在本地文件夹里。

两种可行的解决方案 #

方案1：保留django_heroku，手动恢复S3存储配置

如果你还需要django_heroku帮你处理其他Heroku相关配置（比如数据库、日志），可以在调用它的设置方法之后，手动重新覆盖静态文件存储的配置：

import django_heroku

# 先让django_heroku处理基础配置
django_heroku.settings(locals())

# 重新设置静态文件和媒体文件的存储后端为S3
STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'

# 如果你之前有设置STATIC_ROOT，也可以按需调整（S3场景下通常不需要STATIC_ROOT，因为文件直接推去桶里）
# STATIC_ROOT = os.path.join(BASE_DIR, 'staticfiles') # 可选，根据你的需求决定

这样既保留了django_heroku的便利性，又能强制collectstatic把文件推送到S3。

方案2：弃用django_heroku，手动配置Heroku所需项

如果不想依赖django_heroku的自动配置，完全可以手动处理Heroku部署需要的各项设置，这样能彻底掌控所有配置，避免冲突：

import os

# 数据库配置（适配Heroku Postgres）
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql_psycopg2',
        'NAME': os.environ.get('DB_NAME'),
        'USER': os.environ.get('DB_USER'),
        'PASSWORD': os.environ.get('DB_PASSWORD'),
        'HOST': os.environ.get('DB_HOST'),
        'PORT': os.environ.get('DB_PORT'),
    }
}

# 允许的主机（自动适配Heroku应用域名）
ALLOWED_HOSTS = []
if heroku_app_name := os.environ.get('HEROKU_APP_NAME'):
    ALLOWED_HOSTS.append(f"{heroku_app_name}.herokuapp.com")
ALLOWED_HOSTS += ['localhost', '127.0.0.1'] # 本地开发用

# 日志配置（可选，让Django日志输出到Heroku控制台）
LOGGING = {
    'version': 1,
    'disable_existing_loggers': False,
    'handlers': {
        'console': {
            'class': 'logging.StreamHandler',
        },
    },
    'root': {
        'handlers': ['console'],
        'level': 'INFO',
    },
}

# 你的S3静态文件配置（原本的配置保留）
STATICFILES_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
AWS_STORAGE_BUCKET_NAME = os.environ.get('AWS_STORAGE_BUCKET_NAME')
# 其他S3相关配置...

这种方式虽然需要多写几行代码，但完全不会有配置被覆盖的问题，适合需要精细控制部署的场景。

最后提醒一下，不管用哪种方案，执行collectstatic前都要确保你的AWS环境变量（比如AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY）已经正确设置在Heroku的环境变量里，或者本地的.env文件中。

内容的提问来源于stack exchange，提问作者Nick Mancini