使用az webapp部署命令部署Azure Web App异常，与官方Action差异排查

你遇到的问题核心是两种部署工具对部署包结构的处理逻辑完全不同，具体差异如下：

1. 部署包解压路径逻辑 #

• azure/webapps-deploy@v2 Action：会自动解析部署包内容，将包内根层级的所有文件/文件夹直接解压到Azure Web Apps的wwwroot目录根路径。比如你的Web API发布包根目录就是编译后的输出文件（如appsettings.json、Swagger文件夹、程序集文件等），Action会直接把这些内容放到wwwroot，确保应用能找到正确的入口路径。
• az webapp deployment source config-zip CLI命令：默认将压缩包的根文件夹作为子目录完整解压到wwwroot下。如果你的发布包是把编译输出放到了webapp文件夹后再打包，CLI就会把整个webapp文件夹放到wwwroot，导致实际文件路径变为wwwroot/webapp/...，而Azure Web Apps默认从wwwroot根目录加载应用，因此出现404错误。

2. 场景适配与预设配置 #

• azure/webapps-deploy@v2是专为GitHub Actions自动化部署场景设计的工具，内置了针对不同应用类型（ASP.NET Core、Node.js等）的目录结构适配逻辑，无需额外配置就能自动识别应用的发布输出根目录。
• az webapp deployment source config-zip是通用的CLI部署命令，没有针对CI/CD场景做特殊适配，行为更“直白”：严格遵循压缩包的原始结构解压，不会自动识别应用入口目录。要让它和Action行为一致，你需要确保压缩包根目录就是编译后的输出文件（而非包含子文件夹），或者手动调整打包逻辑。

3. 附加功能支持 #

• azure/webapps-deploy@v2附带了自动化部署的配套能力，比如部署前资源校验、部署槽位管理、应用设置注入等，简化了完整CI/CD流程的实现。
• az webapp deployment source config-zip仅提供“上传并解压zip包”的核心功能，其他部署相关的操作需要手动搭配其他Azure CLI命令完成。

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