Docker容器内Cron任务无法执行问题排查求助

问题背景 #

已编写Dockerfile在容器内通过Cron执行Python脚本，具体配置如下：

Dockerfile内容 #

FROM python:3.10.12

# 创建日志目录
RUN mkdir /logs

# 创建工作目录并复制代码
WORKDIR /app
COPY . /app

# 赋予Python和Shell脚本执行权限
RUN find . -name "*.py" -exec chmod +x {} \;
RUN find . -name "*.sh" -exec chmod +x {} \;

# 安装依赖
RUN apt-get -y update && apt-get install -y default-libmysqlclient-dev
RUN pip install -r requirements.txt
RUN apt-get update && apt-get install -y cron && apt-get install -y vim

# 复制Cron配置文件到容器
COPY cronfile.cronjob /etc/cron.d/cronfile.cronjob

# 赋予Cron配置文件权限
RUN chmod 0644 /etc/cron.d/cronfile.cronjob

# 应用Cron任务
RUN crontab /etc/cron.d/cronfile.cronjob

# 创建Cron日志文件
RUN touch /var/log/cron.log

# 启动Cron守护进程
CMD ["cron", "-f"]

Cron配置文件（cronfile.cronjob）内容 #

* * * * * echo "Hello world" `date` >> /var/log/cron.log 2>&1
40 19 * * * /app/crons/test.sh >> /var/log/cron.log 2>&1

当前状态：service cron status显示Cron服务运行正常，crontab -l能看到配置的任务，但Cron任务始终未执行。

排查步骤 #

1. 修复Cron日志权限问题 #

Cron进程默认以root运行，若/var/log/cron.log权限异常会导致无法写入日志。在Dockerfile中添加以下命令确保权限正确：

RUN chown root:root /var/log/cron.log && chmod 644 /var/log/cron.log

2. 验证Shell脚本的可执行性 #

• 进入容器直接执行/app/crons/test.sh，确认脚本本身能正常运行
• 检查脚本开头是否有正确的Shebang（如#!/bin/bash），避免解释器缺失
• 脚本内调用Python时使用绝对路径（如/usr/local/bin/python），Cron的PATH环境变量比终端更受限

3. 修正Cron配置格式 #

/etc/cron.d/目录下的系统级Cron文件必须在时间字段后指定执行用户，否则无法触发。修改cronfile.cronjob内容：

* * * * * root echo "Hello world" `date` >> /var/log/cron.log 2>&1
40 19 * * * root /app/crons/test.sh >> /var/log/cron.log 2>&1

注：若使用crontab命令导入用户级任务，无需指定用户，但建议统一使用一种配置方式，避免格式冲突。

4. 补全Cron的环境变量 #

Cron的默认环境变量PATH不包含Python路径，可在Cron任务中显式指定：

* * * * * root PATH=/usr/local/bin:$PATH echo "Hello world" `date` >> /var/log/cron.log 2>&1

或在test.sh开头添加环境变量声明：

PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin

5. 查看Cron系统日志 #

Cron的执行细节会写入系统日志，可通过以下命令排查：

grep CRON /var/log/syslog

若容器内无syslog，可在Dockerfile中安装rsyslog并启动：

RUN apt-get install -y rsyslog
CMD service rsyslog start && cron -f

系统日志会明确显示任务是否触发、失败原因（如命令不存在、权限不足等）。

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