如何为Puppeteer开启包含全量DevTools信息的控制台verbose日志

排查步骤 #

1. 环境变量设置方式和系统不匹配
   官方给出的命令仅适用于Linux/macOS的bash/zsh类终端，不同系统设置环境变量的语法不同：

• Windows cmd 命令行：

set DEBUG=puppeteer:* && node script.js

• Windows PowerShell：

$env:DEBUG="puppeteer:*"; node script.js

• Linux/macOS 终端：

DEBUG="puppeteer:*" node script.js

如果是在代码内手动设置环境变量，必须在引入puppeteer之前赋值，否则debug模块加载时不会读取到配置：

// 必须写在第一行，早于require('puppeteer')
process.env.DEBUG = 'puppeteer:*'
const puppeteer = require('puppeteer')

2. 检查日志输出流向
   Puppeteer的debug日志默认输出到标准错误流(stderr)而非标准输出流(stdout)，如果你启动脚本时加了2>/dev/null之类的重定向规则，会直接把日志丢弃，控制台就看不到输出。

3. 版本适配问题
   如果你使用的是v19及以上版本的Puppeteer，部分内部命名空间有调整，可以尝试补充puppeteer-core:*的日志规则：

# 兼容新旧版本的全量日志
DEBUG="puppeteer:* puppeteer-core:*" node script.js

更推荐的日志采集方案 #

如果你的核心需求是采集页面控制台日志、网络请求数据，不需要依赖debug模块的原始协议日志，直接通过Puppeteer提供的事件监听就能实现，代码更易维护：

const browser = await puppeteer.launch()
const page = await browser.newPage()

// 采集页面控制台所有输出
page.on('console', msg => {
  console.log(`页面控制台[${msg.type()}]：${msg.text()}`)
})

// 采集所有网络请求、响应
await page.setRequestInterception(true)
page.on('request', req => {
  console.log(`发起请求：${req.method()} ${req.url()}`)
  req.continue()
})
page.on('response', res => {
  console.log(`收到响应：${res.status()} ${res.url()}`)
})

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