Azure Function更新代码后function.json缺失致函数无法运行

问题描述 #

曾发布的Azure Function原本正常运行，仅小幅更新代码未修改任何配置，现在Azure端的function.json文件缺失，导致函数无法运行。使用新发布配置文件重新发布后，仍未生成该文件。

（截图1：Azure Portal中Function应用的文件列表界面，未找到function.json文件；截图2：发布后的文件结构展示，缺少Function对应的配置文件）

本地项目端检查 #

• 确认本地Function目录下function.json存在：若本地已丢失，从备份恢复，或右键Function项目选择重新生成，触发工具自动生成该配置文件。
• 检查发布排除规则：查看.gitignore、.pubxml文件，确认未将function.json加入排除列表；发布配置中选择从本地运行时文件夹发布，确保所有必要文件被包含。

重新发布操作 #

• 启用“删除目标额外文件”：在发布向导的设置页面，勾选该选项，强制用本地完整文件结构覆盖Azure端旧文件。
• 使用Azure CLI强制发布：执行以下命令，确保所有文件上传到位：

  func azure functionapp publish <你的FunctionApp名称> --force
  

Azure端排查修复 #

• 通过Kudu工具验证文件：访问Kudu调试控制台（路径为https://<你的FunctionApp名称>.scm.azurewebsites.net/DebugConsole），进入site/wwwroot目录，检查function.json是否存在；若缺失，手动上传本地的配置文件。
• 核对运行时版本：在Azure Portal的FunctionApp配置中，确认运行时版本与本地项目完全一致，版本不匹配会导致配置文件生成失败。
• 重启FunctionApp：在Portal中找到对应应用，点击重启，清除运行时缓存后再次检查文件状态。

其他排查点 #

• 检查Function属性输出路径：右键本地Function项目，查看属性中的输出路径，确保function.json被正确生成到发布目录。
• 关闭远程构建（若启用）：若开启了Azure远程构建，需确认项目文件（如.csproj）中正确配置了Function元数据，否则远程构建无法生成function.json。

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