Azure Web App应用发布失败求助：缺失oryx-manifest.toml文件

问题背景 #

严格遵循Microsoft官方文档操作，在Azure Web App发布个人网站时出现异常，报错提示：

Could not find build manifest file at '/home/site/wwwroot/oryx-manifest.toml'

手动创建该文件后问题仍未解决。

报错截图：

日志截图：

解决方案 #

oryx-manifest.toml是Azure的Oryx构建工具在构建过程中自动生成的配置文件，手动创建的文件因缺少构建上下文信息无法被识别，以下是针对性解决步骤：

1. 确认构建自动化配置 #

• 如果是本地预构建后上传：
  登录Azure门户，进入目标Web App的「配置」→「常规设置」，将「构建自动化」设置为关闭，避免Oryx尝试读取不存在的构建清单。
• 如果是源码自动构建：
  确保部署的是完整源码而非预构建产物，Oryx需要从源码生成manifest文件。

2. 清理现有文件并重新部署 #

• 通过Kudu工具清理目标目录：
  进入Web App的「高级工具」→「Go」，打开Kudu控制台，执行命令：

  rm -rf /home/site/wwwroot/*
  

• 重新部署源码（Git/DevOps流水线/VS发布均可），发布时勾选「删除目标位置的额外文件」（VS发布），确保部署过程触发完整构建。

3. 手动触发Oryx构建验证 #

在Kudu控制台中执行以下命令，手动触发构建并检查manifest文件是否生成：

# 确认Oryx版本
oryx --version
# 从源码目录构建到wwwroot
oryx build /home/site/repository -o /home/site/wwwroot

构建完成后查看/home/site/wwwroot目录下是否生成oryx-manifest.toml，同时检查构建日志是否有其他报错。

4. 调整Zip部署参数 #

如果使用Azure CLI的Zip部署命令：

• 若需要Azure侧构建源码：

  az webapp deployment source config-zip --resource-group <你的资源组> --name <你的Web App名称> --src <本地压缩包路径> --build-local false
  

• 若已本地预构建完成：

  az webapp deployment source config-zip --resource-group <你的资源组> --name <你的Web App名称> --src <本地压缩包路径> --build-local true
  

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