Docker后台模式运行Python定时脚本重复打印问题排查

问题现象 #

Python定时脚本在本地运行正常，每分钟打印一次"Hello"；但通过Docker后台模式（docker run -d image）启动时，每分钟重复打印两次"Hello"，交互式模式（docker run -it image）则无此问题。

可能原因 #

1. 容器时区与脚本时区不一致：Docker默认使用UTC时区，脚本指定Europe/London时区，可能导致croniter的定时时间计算出现偏差，触发重复执行。
2. 无TTY环境下的日志捕获异常：后台模式无TTY，Docker日志驱动可能对短输出进行重复捕获，造成重复打印的假象。
3. croniter时区处理逻辑异常：使用带时区的datetime时，croniter的get_next方法在无TTY环境下可能出现计算错误。

解决方案 #

方案1：统一容器与脚本时区

在Dockerfile中添加时区配置，确保容器系统时区与脚本一致，同时移除冗余的虚拟环境激活命令：

# 使用官方Python镜像
FROM python:3.11-slim-buster

# 设置容器时区为Europe/London
RUN ln -snf /usr/share/zoneinfo/Europe/London /etc/localtime && echo Europe/London > /etc/timezone

# 设置工作目录
WORKDIR /app

# 创建虚拟环境并配置PATH
RUN python -m venv venv
ENV PATH="/app/venv/bin:$PATH"

# 复制依赖文件并安装
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 复制应用代码
COPY . .

# 启动应用
CMD ["python", "-u", "app.py"]

方案2：简化定时逻辑（替代croniter）

避免依赖croniter的时区处理，直接计算到下一分钟的等待时间：

import time
from pytz import timezone
from datetime import datetime

def main():
    print('Starting...')
    tz = timezone('Europe/London')
    
    while True:
        now = datetime.now(tz)
        # 计算距离下一分钟整分的等待秒数
        wait_time = 60 - now.second - now.microsecond / 1000000
        time.sleep(wait_time)
        
        # 打印带时间戳的内容，方便排查
        print(f'Hello at {now.strftime("%Y-%m-%d %H:%M:%S")}')

main()

方案3：验证日志真实性

若怀疑是日志显示问题，可查看容器原始日志确认是否真的重复输出：

docker logs --tail 20 <容器ID>

通过时间戳判断两次打印是否属于同一分钟，区分是脚本执行问题还是日志捕获问题。

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