.NET 6 Azure Function时间触发器部署后404无法触发

本地运行正常、部署后定时器既不按计划自动触发、也无法在门户手动调用、触发返回404是.NET 6进程内模型Azure函数部署的高频问题，按以下优先级排查修复：

1. 触发器未同步（最高发原因） #

• 触发原因：Visual Studio发布时默认不会自动同步触发器配置，Azure云端未识别到函数的定时器绑定，所有触发请求直接返回404，调度器也不会注册定时任务
• 排查方式：进入函数应用门户的「函数」列表，打开对应定时器函数的「集成」页，若未显示Timer触发器绑定信息即可确认
• 修复方案：
  • 回到Visual Studio发布配置页，勾选发布时同步触发器选项，重新发布
  • 不想重新发布的话，可直接在Azure CLI执行同步命令：az functionapp function synctriggers --name <函数应用实例名> --resource-group <实例所在资源组名>
  • 操作完成后等待1-2分钟，再测试触发即可

2. 函数运行时版本不匹配 #

• 触发原因：已配置FUNCTIONS_WORKER_RUNTIME: dotnet代表使用.NET 6进程内模型，该模型要求Azure Functions运行时版本为V4，若云端运行时误选V3或其他版本，会导致函数集加载失败，所有函数不可用
• 排查方式：进入函数应用「配置」-「函数运行时设置」，查看运行时版本项
• 修复方案：将运行时版本调整为~4，保存后等待实例自动重启，再检查函数加载状态

3. 发布过程文件缺失 #

• 触发原因：增量发布时可能出现文件覆盖异常，导致定时器函数对应的function.json绑定配置未正确上传，Azure无法识别函数触发类型
• 排查方式：打开函数应用的高级工具(Kudu)，进入调试控制台定位到site/wwwroot/路径下对应函数的文件夹，检查function.json是否存在、是否包含正确的timerTrigger绑定配置与cron表达式
• 修复方案：
  • 在Visual Studio发布配置中勾选发布前删除目标位置所有现有文件，执行全量发布
  • 检查项目.csproj文件，确认没有错误配置将function.json排除在发布内容外，同时移除不必要的<IsTransformWebConfigDisabled>true</IsTransformWebConfigDisabled>配置

4. 包运行配置异常 #

• 触发原因：若开启了WEBSITE_RUN_FROM_PACKAGE配置但发布时包文件上传不完整，会出现站点可访问但函数代码未实际加载的情况，所有函数调用返回404
• 排查方式：进入「配置」-「应用程序设置」，查看WEBSITE_RUN_FROM_PACKAGE配置项
• 修复方案：若采用常规直接发布模式，直接删除该配置项，勾选全量清理发布选项后重新部署即可

验证标准 #

所有调整完成后，在门户函数列表确认对应定时器函数状态为「已启用」，在「代码+测试」页点击手动运行，返回202接受状态即代表修复完成，后续函数会按配置的cron规则自动执行。

内容的提问来源于stack exchange，提问作者G.Mich