Docker部署Django时runserver后自动启动线程异常求助

本地部署时，在Django项目中通过apps.py的ready方法启动线程一切正常：

scraper/apps.py 代码 #

from django.apps import AppConfig
import threading

class ScraperConfig(AppConfig):
    default_auto_field = 'django.db.models.BigAutoField'
    name = 'scraper'
    def ready(self):
        from .functions import start_scraper
        threading.Thread(target=start_scraper).start()

但Docker部署时，服务器要等该线程执行完成才会启动，Dockerfile配置如下：

Dockerfile 代码 #

FROM python:3.8

ENV PYTHONDONTWRITTEBYTEBYTECODE=1
ENV PYTHONUNBUFFERED=1

RUN mkdir -p /app

WORKDIR /app

COPY ./core .

RUN pip3 install pip --upgrade
RUN pip3 install -r requirements.txt

CMD yes yes | python3 manage.py makemigrations && \
        python3 manage.py migrate && \
        yes yes | python3 manage.py collectstatic && \
        python3 manage.py create_superuser && \
        python3 manage.py runserver 0.0.0.0:${SCRAPER_OUTER_PORT} 

奇怪的是，通过服务器REST API端点触发该线程运行完全正常，但希望它能在runserver后自动启动，怀疑问题出在Docker配置上。

已尝试以下方法，均未解决：

• 使用python:3.8-slim-buster镜像
• 使用ubuntu:20.04镜像
• 使用gunicorn启动服务器
• 使用ASGI应用启动服务器
• 将所有CMD命令写入init.sh脚本并赋予可执行权限

解决方案 #

核心问题 #

Django启动时ready方法可能被多次触发（比如runserver的自动重载机制），且未将线程设置为守护线程，导致长期运行的线程阻塞主进程，使服务器无法正常启动。

修复步骤 #

1. 修改apps.py，优化线程启动逻辑
   添加守护线程配置，同时避免ready方法重复执行：

   from django.apps import AppConfig
   import threading
   import os
   
   class ScraperConfig(AppConfig):
       default_auto_field = 'django.db.models.BigAutoField'
       name = 'scraper'
       def ready(self):
           # 仅在主进程中启动线程，规避runserver自动重载的重复执行问题
           if os.environ.get('RUN_MAIN') == 'true':
               from .functions import start_scraper
               scraper_thread = threading.Thread(target=start_scraper)
               scraper_thread.daemon = True  # 设置为守护线程，随主进程终止自动结束
               scraper_thread.start()
   

2. 优化Dockerfile，消除交互式操作阻塞
   原配置中yes yes | ...和create_superuser的交互式输入会导致异常，改用无参数模式配合环境变量完成配置：

   FROM python:3.8
   
   ENV PYTHONDONTWRITEBYTECODE=1
   ENV PYTHONUNBUFFERED=1
   # 预定义超级用户参数
   ENV DJANGO_SUPERUSER_USERNAME=admin
   ENV DJANGO_SUPERUSER_EMAIL=admin@example.com
   ENV DJANGO_SUPERUSER_PASSWORD=admin123
   
   RUN mkdir -p /app
   
   WORKDIR /app
   
   COPY ./core .
   
   RUN pip3 install --upgrade pip
   RUN pip3 install -r requirements.txt
   
   CMD python3 manage.py makemigrations && \
       python3 manage.py migrate && \
       python3 manage.py collectstatic --noinput && \
       python3 manage.py createsuperuser --noinput && \
       python3 manage.py runserver 0.0.0.0:${SCRAPER_OUTER_PORT}
   

3. 生产环境建议
   生产环境不推荐使用runserver，建议用gunicorn作为Web服务器，同时将线程任务拆分为独立进程启动，避免与Web服务耦合：

   # 自定义管理命令启动线程任务，后台运行
   python3 manage.py start_scraper &
   # 启动gunicorn服务
   gunicorn core.wsgi:application --bind 0.0.0.0:8000
   

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