Docker中runserver启动Django时admin页面CSS不生效如何解决

问题场景 #

使用Docker部署Django 3.0开发环境，通过runserver启动服务后，访问本地服务Django Admin后台样式完全丢失，无法加载CSS资源。

现有配置信息 #

Dockerfile

FROM python:3.8.3-alpine

WORKDIR /usr/src/app

ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1

RUN pip install --upgrade pip

COPY ./requirements.txt .

RUN pip install -r requirements.txt

COPY . .

docker-compose.yml

version: '3.7'

services:
  web:
    build: ./django_project
    command: python manage.py runserver 0.0.0.0:8000
    volumes:
      - ./django_project/:/usr/src/app/
    ports:
      - 8000:8000

环境版本

• Docker Desktop: 4.1.1
• Python: 3.8
• Django: 3.0

根因说明 #

这个问题和端口映射无关，核心是Django开发模式下静态资源托管逻辑没正常生效，要么是settings配置缺项，要么是Alpine镜像下挂载卷的目录权限导致Django读不到自带的admin静态文件。

修复步骤 #

1. 先检查Django项目下的settings.py配置，确保以下配置项正确：
   • 开发环境下设置DEBUG = True，Django只有在DEBUG模式下才会自动托管静态资源
   • INSTALLED_APPS列表中必须包含django.contrib.staticfiles，这个是Django自带的静态文件处理模块，Admin的样式托管全靠它
   • 确认存在静态路径配置：STATIC_URL = '/static/'，注意开发环境不要提前配置STATIC_ROOT，这个参数是生产环境执行collectstatic用的，配了反而会干扰开发模式的静态资源路由
   • 确认ALLOWED_HOSTS包含本地访问地址，比如设置为ALLOWED_HOSTS = ['localhost', '127.0.0.1', '0.0.0.0']，避免请求被拦截
2. 修复Alpine镜像的目录权限问题，在Dockerfile的最后一行新增权限配置，避免挂载卷后Django无权限读取静态文件：

   COPY . .
   # 新增下面这行
   RUN chmod -R 755 /usr/src/app
   

3. 清除旧容器缓存重新构建启动，在项目根目录执行以下命令：

   docker-compose down -v
   docker-compose build --no-cache
   docker-compose up
   

4. 要是重启后还是没样式，直接进入运行中的web容器执行一次静态文件收集命令即可：

   docker-compose exec web python manage.py collectstatic --noinput
   

避坑提示：不要随便给runserver加--insecure参数，这个参数是DEBUG=False时强制Django托管静态文件用的，开发环境DEBUG=True的场景下加这个参数反而可能导致静态路径匹配异常。

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