Docker部署FastAPI应用时容器内cron定时任务不执行问题

我在家庭实验室环境下开发网页爬虫类应用，核心设备是一台Intel NUC，家庭内网访问地址为192.xxx.x.xx。
NUC上通过nginx做反向代理，将入站HTTP请求转发到docker容器，容器内部署fastapi应用处理业务逻辑，相关代码配置如下：

app.main.py #

import os
from pathlib import Path
from fastapi import FastAPI

app = FastAPI()
cron_path = Path(os.getcwd(), "app", "cron.log")

@app.get("/cron")
def cron():
    with cron_path.open("rt") as cron:
        return {"cron_state": cron.read().split("\n")}

app.cronjob.py #

import os
from pathlib import Path
from datetime import datetime

cron_path = Path(os.getcwd(), "app", "cron.log")

def append_time():
    with cron_path.open("rt") as filein:
        text = filein.read()
        text += f"\n{datetime.utcnow().strftime('%Y-%m%dT%H:%M:%SZ')}"
        
    with cron_path.open("wt") as fileout:
        fileout.write(text)

if __name__ == "__main__":
    append_time()

cron-job 定时配置 #

* * * * * python3 /code/app/cronjob.py
# 配置文件末尾需保留空行才是合法cron配置

Dockerfile #

FROM python:3.10-slim-buster

WORKDIR /code

COPY ./cron-job /etc/cron.d/cron-job
COPY ./app /code/app
COPY ./requirements.txt /code/requirements.txt

# 给cron任务加执行权限
RUN chmod 0644 /etc/cron.d/cron-job
# 安装cron
RUN apt-get update
RUN apt-get -y install cron
# 加载cron任务
RUN crontab /etc/cron.d/cron-job

RUN pip install --no-cache-dir --upgrade -r /code/requirements.txt

EXPOSE 8080

CMD crontab ; uvicorn app.main:app --host 0.0.0.0 --port 8080

目前FastAPI应用可以正常访问，但配置的cron定时任务始终不执行，想确认是现有配置有遗漏，还是更适合用from fastapi_utils.tasks import repeat_every这类纯Python实现的定时方案。

你的cron任务不执行完全是配置存在遗漏，和方案选型无关，两种定时实现方式各有适用场景，现有cron配置的具体问题如下：

• cron服务根本没启动：Dockerfile启动命令里的crontab命令只会打印当前加载的定时任务列表，执行完就直接退出，从头到尾没有启动cron守护进程，任务自然不会被触发。
• cron任务格式不符合要求：放在/etc/cron.d/目录下的定时任务，比用户级crontab多一个必填字段：需要指定执行任务的系统用户，当前配置缺了这个字段，cron服务就算启动了也不会执行该任务。
• 执行路径风险：cron运行时的环境变量和交互式shell完全独立，不加载PATH里的自定义路径，直接写python3大概率会找不到可执行文件，必须写Python解释器的绝对路径。

现有cron方案修正方法 #

• 修改cron-job配置文件，补全用户字段、写死Python绝对路径：

  * * * * * root /usr/local/bin/python3 /code/app/cronjob.py
  # 末尾保留空行
  

• 修改Dockerfile的启动命令，先启动cron服务再拉起uvicorn：

  # 原有配置不变，最后CMD替换为
  CMD cron && uvicorn app.main:app --host 0.0.0.0 --port 8080
  

• 如果需要排查cron运行问题，可以在安装cron的步骤后加一行RUN touch /var/log/cron.log，后续直接查看这个文件的日志定位问题。

两种定时方案选型建议 #

• 如果应用只跑单实例，定时任务逻辑和web业务强绑定、没有重资源消耗，直接用repeat_every这类纯Python方案更省心：不用处理cron的系统配置坑，任务和应用同生命周期，日志直接走FastAPI的日志体系，调试成本极低。简单用法示例：

  # 在app/main.py里添加
  from fastapi_utils.tasks import repeat_every
  
  @app.on_event("startup")
  @repeat_every(seconds=60)
  def run_cron_job():
      from app.cronjob import append_time
      append_time()
  

  这种写法不需要额外安装系统组件，也不用调整容器启动命令，写完直接生效。
• 如果后续要多实例部署应用，或者定时任务是CPU/IO密集型的重任务，不想和web服务抢占资源，那把cron配置正确，或者干脆把定时任务拆成独立容器部署更合理，也能避免多实例同时运行重复执行任务的问题。

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