Railway部署Django应用遇静态文件MIME类型错误求助

问题根源 #

你请求的https://www.floriskruger.com/templates/css/home.css返回了HTML文件（MIME类型显示text/html），说明静态文件的请求没被Django正确处理，反而被路由导去了某个返回HTML的视图（比如404页面或者首页）。本地正常是因为开发模式下Django自动帮你处理静态文件，生产环境的逻辑完全不一样，而且你部署时大概率没做好静态文件的收集和配置。

一步步解决的方法 #

1. 改对HTML里的静态文件引用路径 #

你现在直接写/templates/css/home.css是错的。Django生产环境下必须用{% static %}模板标签引静态文件，不能直接指向templates目录（templates是放HTML模板的地方，不是静态文件的正确存储位置）。

错误写法：

<link rel="stylesheet" href="/templates/css/home.css">

正确写法（先在模板最顶部加{% load static %}）：

{% load static %}
<link rel="stylesheet" href="{% static 'css/home.css' %}">

2. 修正settings.py里的静态文件配置 #

确保这些配置正确：

# collectstatic命令会把所有静态文件收集到这个目录，生产环境必须设
STATIC_ROOT = BASE_DIR / 'staticfiles'

# 静态文件的URL前缀，对应{% static %}生成的路径开头
STATIC_URL = '/static/'

# 如果你的静态文件放在templates/css或者其他非默认位置，要加到这里
STATICFILES_DIRS = [
    BASE_DIR / 'templates/css',
    # 要是你把静态文件统一放在项目根目录的static文件夹下，就写BASE_DIR / 'static'
]

3. 部署时一定要执行collectstatic #

在Railway的部署配置里，得加个启动前的命令来收集静态文件。比如在Procfile或者railway.toml里写：

web: python manage.py collectstatic --noinput && gunicorn 你的项目名.wsgi

--noinput是避免部署时弹出确认提示，适合自动化部署。

4. 用Whitenoise处理静态文件服务 #

Django本身在生产环境不负责给用户提供静态文件，得靠Whitenoise中间件：

• 先装Whitenoise：pip install whitenoise
• 在settings.py的MIDDLEWARE里加一行（要放在django.middleware.security.SecurityMiddleware后面）：

MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'whitenoise.middleware.WhiteNoiseMiddleware',  # 加这行
    # 其他中间件照原来的留着
]

• 可选：开启压缩和缓存，提升加载速度，在settings.py末尾加：

STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'

5. 检查urls.py的路由 #

生产环境下不用在urls.py里加本地开发用的static路由，但要注意别让捕获所有的路由（比如path('', views.home)）覆盖了/static/开头的请求，确保静态文件的URL能被Whitenoise正确处理。

验证方法 #

1. 本地先跑python manage.py collectstatic，看看staticfiles目录里有没有生成所有的css、js文件
2. 检查页面渲染后的静态文件路径是不是/static/css/home.css这种格式
3. 部署后直接访问https://www.floriskruger.com/static/css/home.css，确认能正常下载css文件，而不是返回HTML页面

内容的提问来源于stack exchange，提问作者Floris Kruger