Azure DevOps部署NodeJS Azure App Service遇解压错误求助

排查Zip包损坏/格式异常问题 #

• 检查归档任务配置：确保Archive Files任务只包含必要文件（排除.git、npm-debug.log、本地.env、node_modules/.cache等冗余内容）；确认归档根目录正确，避免zip内嵌套多余文件夹（比如不要把$(Build.SourcesDirectory)整个打包，而是选项目核心文件所在的子目录）；压缩格式必须选择zip，禁用7z等其他格式。
• 本地验证zip有效性：手动构建项目并打包成zip，解压后确认文件结构（根目录需包含web.config、package.json等关键文件），再用az webapp deployment source config-zip命令手动部署测试，判断是流水线问题还是包本身问题。

优化过大的部署包 #

• 精简依赖：用npm ci --only=production替换npm install，严格按package-lock.json安装生产依赖，跳过devDependencies，大幅缩小node_modules体积。
• 清理构建产物：前端项目仅打包dist文件夹内容，后端项目仅保留业务代码、生产依赖、配置文件，排除源码、测试文件等非必要内容。
• 改用增量部署：在发布流水线中选择增量部署模式，仅上传变更文件，避免每次上传完整大包，同时降低zip损坏概率。

检查Run From Package配置与App Service日志 #

• 验证WEBSITE_RUN_FROM_PACKAGE设置：在Azure门户App Service的配置→应用设置中，确认该值为1（本地包模式）或有效zip URL；可暂时清空该值，改用常规部署测试，排除Run From Package本身的兼容性问题。
• 开启详细日志：在App Service→日志→应用服务日志中，开启详细错误日志和失败请求跟踪，访问应用后查看日志详情，排查是否存在web.config配置错误、端口监听异常等其他问题。

流水线发布步骤检查 #

• 确认发布任务的包路径：Azure App Service Deploy任务需指向构建生成的zip文件，而非文件夹。
• 检查部署方法：若使用Run From Package，确保任务中Run from package file选项已勾选；若用Web Deploy，确认服务主体权限足够，且无文件锁定冲突。

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