Azure App Service单订阅部署.tar.gz未解压问题求助

1. 仅部分订阅出现未解压的原因分析 #

同一流水线生成的部署包在不同订阅表现不同，核心原因大概率是订阅/应用级的隐性部署配置差异或部署服务的版本/区域特性差异：

• 受影响订阅内的Web App可能启用了隐性的快速部署优化：部分订阅的Linux App Service会针对Zip部署启用缓存或跳过解压逻辑（比如针对node_modules这类大目录的特殊处理），但该优化未在所有订阅同步生效。
• 部署引擎版本差异：不同订阅的App Service可能运行不同版本的部署代理，新版本可能调整了Tar.gz文件的解压触发逻辑，而受影响订阅的代理未更新。
• 存储层差异：受影响订阅的App Service使用的底层存储可能存在缓存机制，导致Tar.gz文件未被触发解压流程。

2. 可能影响该行为的配置项 #

应用设置 #

除了WEBSITE_RUN_FROM_PACKAGE，以下设置可能影响解压行为：

• WEBSITE_SKIP_NODE_MODULES_RESTORATION：若设置为true，会跳过自动解压node_modules.tar.gz（即使包内包含该文件）。
• WEBSITE_ENABLE_SYNC_UPDATE_SITE：若设置为false，部署会采用异步模式，可能导致解压流程未被触发。
• WEBSITE_DEPLOYMENT_CACHE_CONTROL：缓存策略可能阻止部署服务重新解压已存在的Tar.gz文件。

App Service Plan配置 #

• 隔离层（Isolated SKU）的App Service Plan可能有专属的部署优化策略，与普通SKU的处理逻辑不同。
• 区域特性：部分Azure区域的App Service部署服务可能处于预览阶段，解压逻辑与稳定区域存在差异。

订阅级策略 #

• Azure Policy：若订阅存在限制Web App部署操作的策略（比如禁止修改文件系统），可能间接阻止Tar.gz解压。
• 资源提供者版本：若受影响订阅的Microsoft.Web资源提供者未注册到最新版本，可能导致部署逻辑滞后。

3. 标准化部署流程的解决方案 #

方案1：显式控制部署包内容 #

在Azure DevOps流水线的构建阶段，直接将node_modules目录打包进部署Zip，而非依赖App Service自动解压Tar.gz：

# 在构建步骤中添加打包逻辑
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(Build.SourcesDirectory)'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'
    replaceExistingArchive: true
    verbose: true

方案2：统一应用设置 #

为所有Web App添加强制解压的应用设置，消除订阅差异：

• 添加WEBSITE_RUN_FROM_PACKAGE=0：强制禁用运行从包模式，触发完整的解压流程。
• 添加WEBSITE_SKIP_NODE_MODULES_RESTORATION=false：明确要求部署服务解压node_modules.tar.gz（若存在）。

方案3：标准化部署验证 #

在流水线的部署后阶段添加验证步骤，确保node_modules目录存在：

- task: AzureCLI@2
  inputs:
    azureSubscription: '$(service_connection)'
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      # 检查node_modules目录是否存在
      az webapp ssh --name $(appservice_name) --resource-group $(resource_group) --command "ls -la /home/site/wwwroot/node_modules"
      if [ $? -ne 0 ]; then
        echo "node_modules目录未生成，部署失败"
        exit 1
      fi

方案4：统一订阅配置 #

• 确保所有订阅的Microsoft.Web资源提供者注册到最新版本：

az provider register --namespace Microsoft.Web

• 检查并移除订阅中可能影响部署的Azure Policy，确保Web App拥有修改文件系统的权限。

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