调整Python运行时Azure Function定时器触发器适配夏令时

核心原因 #

Azure Functions Python宿主在启动阶段通过静态分析识别定时器触发器的CRON表达式，仅支持字面量字符串。动态生成的CRON（如f-string、变量赋值、format格式化）虽然在模块加载时会生成正确字符串，但宿主的静态扫描无法解析这类动态值，导致触发器未被正确注册——即使诊断中心显示CRON正确，实际调度也不会生效。

可行解决方案 #

方案1：使用环境变量存储CRON（推荐，无需修改代码即可调整） #

将CRON表达式存入函数应用的环境变量，在装饰器中通过os.getenv()读取。这种方式既支持动态修改（仅需更新环境变量并重启应用），又能被宿主静态识别：

import os
import azure.functions as func
import logging

app = func.FunctionApp()

# 从环境变量读取CRON，默认值作为 fallback
TIMER_CRON = os.getenv("TIMER_CRON", "0 35 * * * *")

@app.schedule(
        schedule=TIMER_CRON,
        arg_name="myTimer",
        run_on_startup=False,
        use_monitor=True
        ) 
def timer_trigger(myTimer: func.TimerRequest) -> None:
    if myTimer.past_due:
        logging.info('The timer is past due!')
    logging.info('Python timer trigger function executed.')

配置步骤：

• 进入Azure门户的函数应用 → 配置 → 应用程序设置
• 添加新设置：名称TIMER_CRON，值设为目标CRON表达式
• 保存后重启函数应用

方案2：固定CRON+运行时时间判断（无需重启适配夏令时） #

如果需要无需重启即可切换夏令时规则，可以设置一个高频CRON（比如每分钟执行一次），在函数内部判断当前时间是否符合夏令时的触发条件，不符合则直接返回：

import azure.functions as func
import logging
from datetime import datetime
import pytz

def check_dst_status():
    # 替换为你的业务时区，示例为伦敦时区
    tz = pytz.timezone("Europe/London")
    current_time = datetime.now(tz)
    # 返回是否处于夏令时
    return current_time.dst() != datetime.timedelta(0)

@app.schedule(
        schedule="0 * * * * *", # 每分钟执行一次
        arg_name="myTimer",
        run_on_startup=False,
        use_monitor=True
        ) 
def timer_trigger(myTimer: func.TimerRequest) -> None:
    if myTimer.past_due:
        logging.info('The timer is past due!')
    
    # 根据夏令时切换目标分钟
    target_minute = 35 if check_dst_status() else 30
    current_minute = datetime.now().minute
    
    if current_minute != target_minute:
        logging.info("Current time doesn't match DST schedule, skipping.")
        return
    
    # 此处编写实际业务逻辑
    logging.info('Python timer trigger executed (matched DST rule).')

关于“已知Bug”的说明 #

这并非Azure的Bug，而是设计限制。Azure Functions需要在启动阶段确定触发器的调度规则，静态分析是为了确保能正确向底层调度系统注册定时任务。动态生成的CRON无法在静态阶段被提取，因此宿主无法完成触发器的正确注册。

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