Docker部署Django生产环境时Admin界面CSS样式丢失问题

该异常和全局静态配置错误无关，核心是静态收集流程失效，完全匹配「前端静态正常、仅Admin后台样式缺失」的现象：

• 项目自定义的前端静态文件直接存放在代码仓库的static/目录下，Docker构建阶段执行COPY . /app时，已经将这部分文件直接复制到STATIC_ROOT配置的/app/static路径下，不需要依赖collectstatic命令就能被静态服务读取
• 启动脚本中执行python3 manage.py collectstatic时未添加--noinput参数：容器启动属于非交互环境，命令执行时会弹出「是否确认覆盖现有文件」的交互提示，无终端接收输入的情况下命令会直接终止退出，不会执行任何静态收集操作
• Django Admin的静态文件不属于项目代码，默认存放在Python环境的site-packages/django/contrib/admin/static/路径下，必须通过collectstatic命令复制到STATIC_ROOT目录才能被访问，收集流程失效后这部分文件自然缺失
• 额外隐患：当前使用runserver启动生产服务不符合Django部署规范，当DEBUG=False时runserver默认不会代理静态文件请求，就算静态收集完成也可能出现访问异常

按以下步骤调整配置即可解决问题：

• 1. 修改start-server.sh启动脚本，添加非交互参数和错误退出逻辑，避免命令静默失败：

#!/bin/bash
set -e # 任意命令执行失败则直接终止脚本，避免服务在异常状态下启动

echo ".......... start executing collectstatic ........."
python3 manage.py collectstatic --noinput --clear
# --noinput 跳过所有交互提示，适配容器非交互运行环境
# --clear 收集前清空旧静态目录，避免历史脏文件干扰

echo ".......... start executing makemigrations ........."
python3 manage.py makemigrations
echo ".......... start executing migrate ........."
python3 manage.py migrate

echo "Docker started...."
# 临时调试可加--insecure参数，强制在DEBUG=False模式下由runserver提供静态文件服务
# 生产环境禁止长期使用runserver
python3 manage.py runserver 0.0.0.0:8003 --insecure

• 2. 优化Dockerfile，删除冗余的重复COPY指令，减小镜像体积，避免不必要的文件覆盖：

FROM python:3.8.5-slim
WORKDIR /app
COPY ./requirements.txt .

# 安装系统依赖时添加--no-install-recommends减少冗余包，安装后清理apt缓存减小镜像体积
RUN apt-get update && apt-get install -y --no-install-recommends gcc openssh-server libev-dev default-libmysqlclient-dev \
    && rm -rf /var/lib/apt/lists/*

RUN echo PermitRootLogin yes >> /etc/ssh/sshd_config
RUN echo root:newadminpasswd | chpasswd

RUN pip3 install --no-cache-dir -r requirements.txt

COPY . .
RUN cp ./.env.example .env
RUN chmod +x start-server.sh

EXPOSE 8003 22
ENTRYPOINT ["/app/start-server.sh"]

• 3. 生产环境优化（必做）：替换runserver为正式WSGI服务（如gunicorn/uWSGI），搭配Nginx反向代理直接映射STATIC_ROOT目录处理静态请求，不要依赖Django本身处理静态文件服务，性能和稳定性更高。
• 验证方法：重新构建镜像启动容器后，进入容器检查/app/static目录下是否存在admin子目录，若存在说明静态收集成功，刷新Admin页面样式即可恢复。

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