Django部署至Railway后静态文件无法加载，求排查方法

问题详情 #

已按Django官方静态文件部署指南操作，应用成功部署至Railway，但静态文件加载失败，部署日志显示资源404：

Not Found: /static/styles/style.css
Not Found: /static/images/logo.svg
Not Found: /static/styles/style.css
Not Found: /static/images/logo.svg
Not Found: /static/images/avatar.svg
Not Found: /static/images/avatar.svg
Not Found: /static/js/script.js
Not Found: /static/js/script.js

当前settings.py关键配置：

DEBUG = False

STATIC_ROOT = BASE_DIR / "staticfiles"

STATIC_URL = '/static/'

STATICFILES_DIRS = [
    BASE_DIR / "static",
]

MEDIA_URL = '/images/'

MEDIA_ROOT = BASE_DIR / 'static/images'

可能遗漏的关键步骤 #

1. 未配置部署时自动执行collectstatic #

Django生产环境需要将所有静态文件收集到STATIC_ROOT指定目录，Railway默认不会自动执行该命令，需手动配置：

• 在项目根目录创建railway.toml，添加构建命令：

  [build]
  command = "python manage.py collectstatic --noinput && python manage.py migrate"
  

• 或直接在Railway控制台的「Build Command」中设置上述命令。

2. 未配置静态文件服务中间件 #

当DEBUG=False时，Django不会自动处理静态文件请求，需借助whitenoise实现：

1. 安装依赖：pip install whitenoise
2. 在settings.py的MIDDLEWARE列表中添加（放在SecurityMiddleware之后）：

   MIDDLEWARE = [
       'django.middleware.security.SecurityMiddleware',
       'whitenoise.middleware.WhiteNoiseMiddleware',
       'django.contrib.sessions.middleware.SessionMiddleware',
       # 其余原有中间件...
   ]
   

3. 在settings.py末尾追加：

   STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
   

3. 媒体文件路由配置缺失 #

你的MEDIA_URL为/images/，但DEBUG=False时Django默认不处理媒体文件请求，需调整：

• 如果是静态图片（非用户上传），建议将images目录直接放在static下，通过/static/images/路径访问，确保collectstatic能收集到这些文件。
• 如果是用户上传的媒体文件，需在urls.py中配置路由，并依赖whitenoise处理：

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

4. 静态文件目录验证 #

检查STATICFILES_DIRS指向的BASE_DIR / "static"是否存在，且包含styles、images、js目录及对应文件。可在构建命令中加入ls -la static来验证文件是否存在于部署环境中。

内容的提问来源于stack exchange，提问作者jethro-dev