Heroku部署Django博客遇500错误：无法加载login模板求助

一、修复accounts/login.html模板找不到的问题 #

1. 检查模板目录配置
   在settings.py的TEMPLATES配置中，确保DIRS包含你的模板根目录，且APP_DIRS设为True：

   TEMPLATES = [
       {
           'BACKEND': 'django.template.backends.django.DjangoTemplates',
           'DIRS': [BASE_DIR / 'templates'],  # 模板根目录，根据你本地结构调整
           'APP_DIRS': True,
           'OPTIONS': {
               'context_processors': [
                   'django.template.context_processors.debug',
                   'django.template.context_processors.request',
                   'django.contrib.auth.context_processors.auth',
                   'django.contrib.messages.context_processors.messages',
               ],
           },
       },
   ]
   

2. 确认模板文件路径
   确保login.html放在正确的位置：
   • 项目级模板结构：templates/accounts/login.html
   • app级模板结构：your_app/templates/accounts/login.html（需确保该app已加入INSTALLED_APPS）
3. 验证Git提交
   检查.gitignore文件，确保没有忽略模板目录，执行git add .和git commit后重新部署到Heroku。

二、修正静态文件配置（适配Heroku） #

Heroku依赖collectstatic收集静态文件到STATIC_ROOT目录，按以下配置调整settings.py：

1. 基础静态文件设置

   STATIC_URL = '/static/'
   STATICFILES_DIRS = [BASE_DIR / 'statics']  # 对应你本地的statics文件夹
   STATIC_ROOT = BASE_DIR / 'staticfiles'  # 与Heroku提示的/app/staticfiles匹配（Heroku中BASE_DIR即为/app）
   

2. 配置Whitenoise处理静态文件
   • 在requirements.txt中添加whitenoise==6.6.0（版本可按需调整）
   • 在MIDDLEWARE中加入Whitenoise中间件（放在SecurityMiddleware之后）：

     MIDDLEWARE = [
         'django.middleware.security.SecurityMiddleware',
         'whitenoise.middleware.WhiteNoiseMiddleware',  # 新增这一行
         'django.contrib.sessions.middleware.SessionMiddleware',
         'django.middleware.common.CommonMiddleware',
         # 其他中间件...
     ]
     

   • 添加静态文件存储配置：

     STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
     

3. 本地预验证
   本地执行python manage.py collectstatic，确认没有报错后再部署到Heroku。

三、处理文章图片上传及默认图片逻辑 #

Heroku的文件系统是临时的，无法持久存储上传文件，需用云存储（以AWS S3为例）：

1. 安装依赖
   在requirements.txt中添加：

   boto3==1.28.0
   django-storages==1.13.2
   

2. 配置媒体文件与云存储
   在settings.py中添加：

   MEDIA_URL = '/media/'
   # 本地开发用本地存储，生产环境用S3
   if not DEBUG:
       DEFAULT_FILE_STORAGE = 'storages.backends.s3boto3.S3Boto3Storage'
       AWS_ACCESS_KEY_ID = '你的AWS Access Key ID'
       AWS_SECRET_ACCESS_KEY = '你的AWS Secret Access Key'
       AWS_STORAGE_BUCKET_NAME = '你的S3存储桶名称'
       AWS_S3_REGION_NAME = '你的存储桶区域（如us-east-1）'
       AWS_S3_FILE_OVERWRITE = False
       AWS_DEFAULT_ACL = None
   else:
       MEDIA_ROOT = BASE_DIR / 'media'
   

3. 模型中设置默认图片
   在文章模型的图片字段中指定默认值：

   from django.db import models
   
   class Article(models.Model):
       # 其他字段...
       image = models.ImageField(upload_to='article_images/', default='default_article.jpg', blank=True)
   

   • 将默认图片default_article.jpg放在statics或media目录下，本地执行collectstatic后会被收集到静态文件目录；生产环境下需手动上传到S3的对应路径（若默认图片在静态目录中，也可通过collectstatic同步）。
4. 开发环境媒体文件路由
   在项目根urls.py中添加：

   from django.conf import settings
   from django.conf.urls.static import static
   
   urlpatterns = [
       # 你的其他路由...
   ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
   

四、其他排查步骤 #

• 执行heroku run python manage.py migrate，确保数据库迁移完成
• 查看完整Heroku日志：heroku logs --tail，排查是否有其他隐藏错误（如数据库连接、权限问题）

内容的提问来源于stack exchange，提问作者Mail Fun