Azure Functions Linux环境下Puppeteer启动浏览器进程失败求助

问题分析 #

报错提示libgobject-2.0.so.0: cannot open shared object file: No such file or directory，说明Azure Functions的Linux运行环境缺少Chrome无头模式所需的系统级依赖库——远程构建仅负责安装npm包，不会自动配置系统依赖。另外需注意：Linux消费计划（Consumption Plan）的沙箱限制无法运行Chrome，必须使用Premium Plan（EP1/EP2/EP3）或专用计划（Dedicated Plan，如B1/B2/B3等）。

解决方案 #

1. 确认App Service Plan类型 #

检查你的Function App所属的服务计划：

• 若当前是消费计划，升级到Premium或专用计划，否则无法绕过沙箱限制运行Chrome。

2. 安装系统依赖库 #

Azure Functions Linux容器基于Debian，需手动安装Chrome依赖，可通过以下两种方式：

方式一：设置自定义启动命令

在Function App的Configuration → General settings中，将Startup Command设置为：

apt-get update && apt-get install -y libgobject-2.0-0 libglib2.0-0 libgtk-3-0 libnss3 libxss1 libasound2 && func start

该命令会在函数启动前自动安装所有缺失的系统依赖。

方式二：使用自定义Docker镜像

如果启动命令方式无效，可自行构建包含依赖的Docker镜像：

1. 编写Dockerfile，基于Azure Functions官方Node镜像，添加依赖安装步骤：

   FROM mcr.microsoft.com/azure-functions/node:4-node18
   ENV AzureWebJobsScriptRoot=/home/site/wwwroot \
       AzureFunctionsJobHost__Logging__Console__IsEnabled=true
   
   RUN apt-get update && apt-get install -y libgobject-2.0-0 libglib2.0-0 libgtk-3-0 libnss3 libxss1 libasound2
   
   COPY . /home/site/wwwroot
   RUN npm install
   

2. 构建镜像并推送到Azure容器注册表，再将Function App配置为使用该自定义镜像。

3. 配置Puppeteer启动参数 #

在代码中添加适配Azure环境的启动参数，避免沙箱和资源限制问题：

const puppeteer = require('puppeteer');

async function run() {
  const browser = await puppeteer.launch({
    headless: 'new', // 使用新版无头模式
    args: [
      '--no-sandbox',
      '--disable-setuid-sandbox',
      '--disable-dev-shm-usage', // 解决/dev/shm空间不足问题
      '--disable-gpu',
      '--no-zygote'
    ]
  });
  // 后续业务逻辑
  await browser.close();
}

4. 重新发布验证 #

执行远程构建发布命令：

func azure functionapp publish {appname} --build remote

发布完成后触发函数，验证是否正常启动Chrome。

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