AzureWebApp@1部署Node.js至Linux WebApp未同步至site/wwwroot

1. 修正AzureWebApp@1任务的参数配置 #

Linux Web App对部署参数的要求和Windows不同，需确保任务明确指定Node.js运行时栈，否则可能出现任务显示成功但实际未正确部署的情况。示例配置：

- task: AzureWebApp@1
  displayName: 'Azure Web App Deploy'
  inputs:
    azureSubscription: '<你的Azure订阅名称>'
    appName: '<你的Linux Web App名称>'
    package: '$(Build.ArtifactStagingDirectory)/**/*.zip'
    runtimeStack: 'NODE|18-lts' # 需匹配你的项目Node.js版本

2. 切换部署任务适配Linux环境 #

AzureWebApp@1在Linux环境下默认采用Zip包直接运行模式（不解压到site/wwwroot），若需强制将文件同步到目标目录，改用AzureRmWebAppDeployment@4任务并指定Linux相关参数：

- task: AzureRmWebAppDeployment@4
  displayName: 'Deploy to Linux Web App'
  inputs:
    azureSubscription: '<你的Azure订阅名称>'
    WebAppName: '<你的Linux Web App名称>'
    packageForLinux: '$(Build.ArtifactStagingDirectory)/**/*.zip'
    WebAppKind: 'linux'
    enableCustomDeployment: true

3. 检查部署包的目录结构 #

Linux Web App要求部署包的根目录直接包含Node.js应用的核心文件（如package.json、入口文件server.js/index.js），如果zip包内存在额外嵌套层级（比如所有文件都在dist/子目录下），部署后系统无法识别应用入口，会保留默认文件。本地解压zip包确认结构，确保根目录包含启动所需文件。

4. 通过日志定位问题细节 #

登录Azure门户，进入目标Web App：

• 打开日志流，实时查看部署过程中的日志输出，排查是否存在文件复制或解压失败的提示
• 进入高级工具(Kudu)，在Deployment Tools > Deployments中查看最近的部署记录，获取更详细的错误信息

内容的提问来源于stack exchange，提问作者Dennis.Verweij