为什么Puppeteer中无法将变量作为page.goto的URL参数传入

你遇到的Protocol error (Page.navigate): Invalid parameters报错核心原因是传入page.goto的BASE_URL变量为undefined：你定义BASE_URL的逻辑在process.env.NODE_ENV不在预设的三个枚举值内时，会从对象中取到undefined，传给puppeteer的导航方法就会触发参数校验失败。

• 第一步：先校验BASE_URL取值合法性，避免取到undefined
  优先统一NODE_ENV的取值格式，比如统一转小写、去除前后空格，同时增加兜底逻辑，确保一定能取到合法URL
• 第二步：调用page.goto前增加参数校验，提前捕获非法值
• 第三步：补充browser关闭逻辑，避免长时间运行产生内存泄漏

const puppeteer = require('puppeteer');

// 先标准化环境变量取值，避免大小写/前后空格导致匹配失败
const NODE_ENV = (process.env.NODE_ENV || 'staging').trim().toLowerCase();
const BASE_URL = {
  production: 'https://foo.go.id',
  staging: 'https://foo.staging.com',
  development: 'http://localhost:3001',
}[NODE_ENV] || 'https://foo.staging.com'; // 再加一层兜底，极端情况也不会返回undefined

async function screenshotPage(bodyReq) {
  const { idElement, pageUrl, isGeneratePDF, token } = bodyReq;

  const browser = await puppeteer.launch({
    headless: true,
    args: ['--no-sandbox', '--disable-setuid-sandbox'],
  });

  const page = await browser.newPage();

  const override = Object.assign(page.viewport(), { width: 1920 });
  await page.setViewport(override);

  page.setDefaultNavigationTimeout(0);

  // 调用前校验URL合法性
  if (typeof BASE_URL !== 'string' || !BASE_URL.startsWith('http')) {
    throw new Error(`非法的访问地址: ${BASE_URL}, 当前环境变量NODE_ENV为: ${NODE_ENV}`);
  }
  await page.goto(BASE_URL, { waitUntil: 'load', timeout: 0 });
  const screenshot = await page.screenshot()

  await browser.close();
  return screenshot.toString('base64')
}

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