NodeJs+Puppeteer部署至Azure App Service运行失败求助

1. 实例需要的额外配置 #

Azure App Service Linux 默认环境缺少 Puppeteer/Chromium 运行所需的系统依赖，同时需要调整 Puppeteer 的启动参数，具体配置如下：

• 添加系统依赖：在 App Service 的「配置」->「常规设置」->「启动命令」中，设置启动脚本先安装依赖再启动服务，示例命令：

  apt-get update && apt-get install -y libnss3 libatk-bridge2.0-0 libdrm-dev libxkbcommon-dev libgbm-dev libasound-dev libatspi2.0-0 libxshmfence-dev && npm start
  

  （如果使用自定义镜像，可将依赖安装步骤写入 Dockerfile，避免每次启动重复安装）
• 调整 Puppeteer 启动参数：代码中启动浏览器时必须添加无沙箱及内存优化参数，否则会因权限或资源问题启动失败：

  const browser = await puppeteer.launch({
    headless: 'new', // 兼容Chromium 112+的新版无头模式
    args: [
      '--no-sandbox',
      '--disable-setuid-sandbox',
      '--disable-dev-shm-usage', // 解决Linux环境下/dev/shm内存不足问题
      '--disable-gpu'
    ]
  });
  

• 检查资源配额：免费/共享层内存不足会导致 Chromium 启动失败，建议升级到 B1 及以上定价层，确保有足够内存运行浏览器实例。
• 查看应用日志：在 Azure 门户的「监测」->「日志流」中查看具体错误信息，定位启动失败的具体原因（如依赖缺失、权限问题等）。

2. Azure App Service 能否运行 Puppeteer？是否需要其他服务？ #

Azure App Service Linux 完全可以运行 Puppeteer，无需更换其他服务，但需做好上述配置。若遇到以下场景可考虑替代方案：

• 高并发/大量 PDF 生成需求：可使用 Azure Functions 搭配 Puppeteer（需同样配置依赖和启动参数），实现按需扩容；
• 环境一致性要求高：使用自定义 Docker 镜像，将 Node.js、Puppeteer 及系统依赖提前打包，部署到 App Service 或 Azure Container Apps，避免环境差异问题。

3. 如何通过 Azure DevOps 实现自动化部署？ #

可以通过 Azure DevOps 流水线/发布流程实现全自动化部署，核心步骤如下：

• 创建流水线：选择「Node.js」模板或自定义 YAML，示例 YAML 片段：

  trigger:
    - main # 监听主分支提交
  
  pool:
    vmImage: 'ubuntu-latest'
  
  steps:
  - task: NodeTool@0
    inputs:
      versionSpec: '20.x' # 匹配本地开发的Node版本
    displayName: 'Install Node.js'
  
  - script: |
      npm install
    displayName: 'Install dependencies'
  
  - task: AzureWebApp@1
    inputs:
      azureSubscription: '<你的Azure订阅>'
      appName: '<你的App Service名称>'
      package: '.'
    displayName: 'Deploy to Azure App Service'
  

• 配置 CI/CD 触发：设置代码提交到指定分支后自动触发流水线，实现持续部署；
• 自定义镜像部署（可选）：若使用自定义 Docker 镜像，可在流水线中添加「Docker 构建」和「推送至 Azure Container Registry」步骤，再部署到 App Service。

常见问题 #

• 502 错误仍存在：检查 Chromium 启动日志，确认是否有依赖缺失；若使用免费层，尝试升级到基础层测试；
• Puppeteer 下载 Chromium 失败：在 package.json 中添加 PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=true 环境变量，改用系统安装的 Chromium（需确保系统已安装）；
• 启动命令执行失败：确认 App Service 环境支持 apt-get（Linux 环境默认支持），若使用自定义容器需确保镜像包含包管理工具。

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