Docker容器内Quartz scheduler定时任务未触发问题咨询

不需要盲目修改Dockerfile，先按优先级排查以下常见原因，对应调整即可：

• 时区不匹配（90%以上同类问题的根因）
  容器默认时区为UTC，和国内开发环境常用的东八区（Asia/Shanghai）差8小时，本地配置的定时触发时间，在容器内会因为时区偏移匹配不到预期时间点，表现为任务始终不触发。
  修复方式二选一即可：
  1. 在Dockerfile中补充时区配置，根据你用的基础镜像选择对应配置：
     Debian/Ubuntu系基础镜像：

     RUN apt-get update && apt-get install -y --no-install-recommends tzdata && \
         ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
         echo "Asia/Shanghai" > /etc/timezone
     ENV TZ=Asia/Shanghai
     

     Alpine系基础镜像：

     RUN apk add --no-cache tzdata && \
         cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
         echo "Asia/Shanghai" > /etc/timezone
     ENV TZ=Asia/Shanghai
     

  2. 不改Dockerfile，启动容器时传入时区环境变量：启动命令加参数-e TZ=Asia/Shanghai，docker-compose部署的话在service的environment下加TZ=Asia/Shanghai即可。
     额外建议：在Quartz自身配置中明确指定调度时区，不要依赖系统默认配置，比如Spring Boot整合场景加配置：

  spring.quartz.properties.org.quartz.scheduler.timeZone=Asia/Shanghai
  

  排查时可以先进入容器执行date命令，看输出的时间和当前实际时间是否一致，快速确认是不是时区问题。
• Quartz集群模式配置错误
  如果你开启了Quartz集群模式，不要硬编码org.quartz.scheduler.instanceId为固定值，容器重启、扩缩容时节点标识变化会导致集群调度异常，任务无法被正常认领触发，把该配置改为AUTO即可：

  org.quartz.scheduler.instanceId = AUTO
  

• 线程池资源不足
  如果容器配置了严格的CPU、内存限制，Quartz默认线程池线程被阻塞任务占满时，后续任务会排队无法触发，可以根据业务量调整线程池大小：

  org.quartz.threadPool.threadCount = 10
  

  普通邮件发送场景设置10-20个线程足够使用。

注意：不要为了修复这个问题随便给容器加特权模式、或者修改网络模式，这类操作和Quartz调度逻辑无关，只会增加容器安全风险。

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