使用Azure Pipelines部署Vue应用至Azure App Service遇异常求助

问题现象 #

通过Azure Pipelines搭建CI/CD部署Vue应用时，部署后的压缩包未被解压，反而存放在/home/site/wwwroot/Package下的子目录（如/home/site/wwwroot/Client/.zip），导致应用无法正常运行；但手动通过VS Code部署相同的dist文件夹可正常工作，且Pipeline的安装、构建、打包环节均验证正常。

可能原因 #

1. Pipeline归档步骤的路径配置错误，导致部署包包含多余的外层目录（如dist文件夹本身而非其内部文件）
2. Release阶段的Azure App Service Deploy任务未正确指定部署包内容或路径
3. 部署方式（如Run from package）的配置与包结构不匹配

解决建议 #

1. 修正Pipeline中的归档步骤配置 #

在Archive Files任务中确保：

• Root folder or file to archive设置为$(System.DefaultWorkingDirectory)/client/dist（指向dist目录的实际路径）
• 取消勾选Prepend root folder name（或设置为false），确保归档后的压缩包根目录是dist内的所有文件（index.html、static等），而非包含dist文件夹本身

2. 调整Release阶段的部署任务配置 #

在Azure App Service Deploy任务中：

• Package or folder选项指定为Pipeline生成的正确压缩包路径，例如$(System.DefaultWorkingDirectory)/<工件名称>/dist.zip（替换<工件名称>为实际的工件名称）
• 明确选择Deployment method为Zip Deploy，避免使用默认方式；若尝试Run from package，需确保：
  • App Service的应用设置中添加WEBSITE_RUN_FROM_PACKAGE并设置为1
  • 部署包的根目录直接包含前端入口文件（index.html），而非嵌套在dist文件夹中

3. 可选：直接在Build Pipeline中整合部署步骤 #

跳过Release环节，在Build Pipeline的构建步骤后直接添加Azure App Service Deploy任务：

• 任务配置中，Package or folder选择$(System.DefaultWorkingDirectory)/client/dist（直接部署dist目录，无需归档），或指定已正确归档的zip包路径
• 同样选择Zip Deploy作为部署方式

验证步骤 #

1. 重新运行Pipeline，下载生成的工件压缩包，解压后确认根目录为index.html、static等前端文件，无多余外层目录
2. 部署完成后通过Kudu文件管理器查看/home/site/wwwroot目录，确认文件直接存放于此目录下，而非子文件夹中

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