非Root用户运行Django容器时crond定时任务无法执行的问题

核心问题分析 #

你的问题出在crontab归属权、crond启动权限及运行模式三个关键点上：

• 构建阶段在Root用户下生成的crontab，切换到非Root用户后无法被加载
• Alpine的BusyBox crond默认读取当前用户的crontab，非Root用户需要专属的crontab目录和权限
• crond -f是前台运行模式，放在Dockerfile的RUN指令中会直接终止构建流程，放在entrypoint中会阻塞主进程（Gunicorn）启动

分步解决方案 #

1. 修正Dockerfile的用户权限与crontab生成顺序

调整Dockerfile中用户切换、权限赋值和crontab生成的顺序，确保crontab属于非Root用户：

#########
# FINAL #
#########

FROM python:3.9.15-alpine3.16

# 创建用户与目录
RUN mkdir -p /home/user
RUN addgroup -S app && adduser -S useradmin -G app

ENV HOME=/home/user
ENV APP_HOME=/home/user/userapp
RUN mkdir -p $APP_HOME/{static,media}
WORKDIR $APP_HOME

# 安装依赖（补充entrypoint需要的nc工具）
RUN apk update && apk add --no-cache libpq netcat-openbsd
COPY --from=builder /user/wheels /wheels
RUN pip install --no-cache /wheels/*

# 复制项目文件
COPY entrypoint.sh $APP_HOME
COPY . $APP_HOME

# 先给非Root用户赋权，再切换用户生成crontab
RUN chown -R useradmin:app $APP_HOME

USER useradmin
# 生成当前用户的crontab
RUN python $APP_HOME/user/cron.py
RUN crontab -l > $HOME/crontab.txt

# 切回Root创建crond需要的用户专属目录（非必须，但能避免权限问题）
USER root
RUN mkdir -p /var/spool/cron/crontabs && chmod 0600 /var/spool/cron/crontabs && chown -R useradmin:app /var/spool/cron/crontabs
USER useradmin

ENTRYPOINT ["/home/user/userapp/entrypoint.sh"]

2. 修改entrypoint.sh，正确启动后台crond

将crond以后台模式启动，并确保加载当前用户的crontab，不阻塞主进程：

#!/bin/sh

echo "Running Django management commands..."

if [ "$DATABASE" = "postgres" ]
then
    echo "Waiting for postgres..."
    while ! nc -z $SQL_HOST $SQL_PORT; do
      sleep 0.1
    done
    echo "PostgreSQL started"
fi

echo "Applying database migrations..."
python manage.py migrate --no-input
echo "Collecting static files..."
python manage.py collectstatic --no-input

# 启动非Root用户的crond后台进程
echo "Starting crond service..."
# 加载当前用户的crontab
crontab $HOME/crontab.txt
# 后台运行crond并输出日志到stdout
crond -b -L /dev/stdout

echo "Starting Gunicorn..."
echo "Importing manufacturers..."
exec "$@"

3. 验证定时任务的执行环境

• 定时任务中的命令必须使用绝对路径：比如用which python在容器中查询Python路径，替换任务中的python为绝对路径（如/usr/local/bin/python），避免非Root用户PATH环境变量缺失问题
• 给定时任务添加日志输出：在任务末尾追加>> $APP_HOME/cron_task.log 2>&1，方便排查执行情况，例如：

  */5 * * * * /usr/local/bin/python $APP_HOME/user/your_task.py >> $APP_HOME/cron_task.log 2>&1
  

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