基于GitHub Actions实现Azure Functions远程构建部署可行性咨询

算力阿峰

2026-8-11

解决Azure Function + Puppeteer在GitHub Actions部署中找不到Chromium的问题

首先明确：用GitHub Actions实现Azure Function的持续部署+Puppeteer是完全可靠可行的，不需要转回手动部署，问题核心是构建流程中没有正确处理Chromium的安装与路径配置。

以下是针对性的修复步骤：

调整GitHub Actions构建脚本，确保Chromium正确安装
在你的GitHub Actions workflow文件（比如.github/workflows/deploy.yml）中，安装依赖时要明确禁止跳过Chromium下载：
```
- name: Install dependencies
  run: |
    npm install
    # 强制下载适配Azure运行环境的Chromium
    PUPPETEER_SKIP_CHROMIUM_DOWNLOAD=false npm install puppeteer
```
也可以直接在package.json的scripts中添加环境变量，确保每次安装依赖都自动下载Chromium。

配置Azure Function中Puppeteer的Chromium路径
Azure Function的容器环境路径与本地不同，需要在代码中指定正确的Chromium执行路径，并添加必要的启动参数：

const puppeteer = require('puppeteer');

async function run() {
  const browser = await puppeteer.launch({
    // 自动获取Puppeteer安装的Chromium路径
    executablePath: puppeteer.executablePath(),
    // Azure容器环境必需的启动参数，规避沙箱权限问题
    args: ['--no-sandbox', '--disable-setuid-sandbox', '--disable-dev-shm-usage']
  });
  // 后续业务逻辑...
}

确保Chromium被纳入部署包
检查.funcignore和.gitignore文件，不要排除node_modules/.local-chromium目录，保证这个存储Chromium的文件夹能被打包到Azure Function的部署包中。
添加构建验证步骤
在GitHub Actions的构建流程中加入验证环节，确认Chromium已成功安装：
```
- name: Verify Chromium installation
  run: |
    ls -la node_modules/puppeteer/.local-chromium/
```
如果输出能看到对应平台的Chromium文件夹，说明安装环节没有问题。