如何在AWS Lambda中根据环境切换Puppeteer包导入？

1. 封装统一导入模块（最省心的方式） #

建一个专门的封装文件，比如puppeteer-loader.js，所有项目文件都从这里导入Puppeteer，不用再直接写require('puppeteer')：

// puppeteer-loader.js
let puppeteer;

// 识别AWS Lambda环境——Lambda会自带AWS_EXECUTION_ENV环境变量
const runningOnLambda = process.env.AWS_EXECUTION_ENV?.startsWith('AWS_Lambda_');

if (runningOnLambda) {
  puppeteer = require('puppeteer-core');
  // Lambda上跑puppeteer-core需要加些启动参数，还要指定Chromium路径（通常Lambda层里的路径是/opt/chrome/chrome）
  puppeteer.customLaunchOptions = {
    executablePath: '/opt/chrome/chrome',
    args: ['--no-sandbox', '--disable-setuid-sandbox']
  };
} else {
  // 本地或其他服务器用完整的puppeteer
  puppeteer = require('puppeteer');
}

module.exports = puppeteer;

之后把项目里所有导入Puppeteer的代码，改成导入这个loader：

// 替换原来的 const puppeteer = require('puppeteer');
const puppeteer = require('./puppeteer-loader');

// 调用的时候，Lambda环境可以用预设的配置
const browser = await puppeteer.launch(runningOnLambda ? puppeteer.customLaunchOptions : {});

这样只需要改一次导入路径，后续所有环境切换都由这个loader自动处理。

2. 直接用环境变量做条件导入（适合ES模块） #

如果你的项目用的是ES模块（import/export），可以直接在代码里做异步条件导入：

const isLambda = process.env.AWS_EXECUTION_ENV?.startsWith('AWS_Lambda_');
const puppeteer = isLambda ? await import('puppeteer-core') : await import('puppeteer');

// 同样要给Lambda环境配置启动参数
const browser = await puppeteer.default.launch({
  ...(isLambda ? { executablePath: '/opt/chrome/chrome', args: ['--no-sandbox'] } : {})
});

这种方式不用额外建文件，但需要确保代码支持顶级await，或者把逻辑放在异步函数里。

额外提醒 #

• Lambda上跑puppeteer-core必须搭配Chromium，你可以用AWS提供的Chromium层，或者自己打包上传，记得把executablePath设对。
• 要是不想依赖Lambda自带的环境变量，也可以自己定义一个，比如在Lambda的环境变量里加USE_CORE=true，代码里判断process.env.USE_CORE === 'true'就行，更灵活。

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