GitHub Action部署Azure App Service时上传Zip而非内容的解决方法

1. 修正部署步骤的package参数配置 #

azure/webapps-deploy@v2动作支持自动解压指定的Zip包到App Service的wwwroot目录，核心是确保package参数直接指向你的构建产物Zip包路径。示例配置如下：

- name: 下载构建产物
  uses: actions/download-artifact@v4
  with:
    name: ASP-app
    path: ./deploy-package

- name: 部署到Azure App Service生产槽位
  uses: azure/webapps-deploy@v2
  with:
    app-name: 'MyApi'
    slot-name: 'production'
    # 直接指向下载后的Zip包路径
    package: './deploy-package/ASP-app.zip'

2. 验证构建产物Zip包的内容结构 #

确保你的构建流程生成的ASP-app产物Zip包内，web.config、网站页面、代码文件等内容直接处于Zip包的根目录，而非嵌套在子文件夹中。如果构建时将文件放在子目录再压缩，部署后wwwroot下会出现对应子目录，而非直接的网站文件。

3. 排查是否误将Zip包作为普通文件上传 #

如果之前的部署逻辑未正确使用package参数（比如用Azure CLI命令时未添加--type zip参数），会导致仅上传Zip包而不解压。使用azure/webapps-deploy@v2的package参数是最可靠的方式，它会自动处理解压部署逻辑。

4. 可选：Run From Package模式（按需使用） #

如果不需要将文件解压到wwwroot，而是让App Service直接从Zip包运行，可以在App Service的应用设置中添加WEBSITE_RUN_FROM_PACKAGE=1。但此模式下wwwroot为只读状态，仅适合无需动态修改文件的场景。

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