Pyppeteer常见问题有三类：一是page.goto()默认等待load事件导致SPA超时，应改用waitUntil='networkidle2'或None并配合waitForSelector；二是截图空白因JS渲染滞后，需waitForFunction判断真实内容挂载；三是浏览器启动失败源于Chromium未安装或沙箱权限问题，须预执行pyppeteer.install()并配置对应启动参数。
Pyppeteer 启动就报 TimeoutError: Navigation timeout of 30000 ms exceeded
这不是网络慢，是默认没关掉页面自动等待加载的“智能超时”机制。Pyppeteer 的 page.goto() 默认会等 load 事件，但很多 SPA 页面（比如 React/Vue）根本不会触发完整 load，它卡在那儿干等。
- 加
waitUntil='networkidle2'：适合等接口基本发完，比load更靠谱 - 或直接关掉等待：
waitUntil=None，后续用page.waitForSelector()精准等元素 - 别只调大 timeout——
timeout=60000只是掩盖问题，不是解决
await page.screenshot() 保存的图片是空白或截不到动态内容
截图时机不对。Pyppeteer 不会等 JS 渲染完成才截图，它只管 DOM 是否“就位”，而 Vue/React 的真实渲染常滞后于 DOM 插入。
- 截图前加
await page.waitForFunction('window.__POWERED_BY_QIANKUN__ !== undefined || document.querySelector("#app")')这类判断真实内容是否挂载的断言 - 避免用
time.sleep()，它不等事件，只是瞎等；asyncio.sleep() 也不推荐，不可靠 - 如果页面有懒加载图片，得额外
await page.evaluate('window.scrollTo(0, document.body.scrollHeight)')再等几秒
Pyppeteer 启动时报 pyppeteer.errors.BrowserError: Failed to launch browser
核心原因是 Chromium 二进制缺失或权限/沙箱冲突，尤其在 Linux 服务器或 Docker 容器里高频出现。
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 首次运行必须先执行
pyppeteer-install（命令行）或代码中加import pyppeteer; pyppeteer.install()，否则它不会自动下载 Chromium - Docker 中要加启动参数：
--no-sandbox --disable-setuid-sandbox --disable-gpu --single-process - Ubuntu 上缺依赖？装：
apt-get install -y gconf-service libasound2 libatk1.0-0 libc6 libcairo2 libcups2 libdbus-1-3 libexpat1 libfontconfig1 libgcc1 libglib2.0-0 libgtk-3-0 libnspr4 libpango-1.0-0 libpangocairo-1.0-0 libstdc++6 libx11-6 libx11-xcb1 libxcb1 libxcomposite1 libxcursor1 libxdamage1 libxext6 libxfixes3 libxi6 libxrandr2 libxrender1 libxss1 libxtst6 ca-certificates fonts-liberation libappindicator1 libnss3 lsb-release xdg-utils wget
怎么让 Pyppeteer 真正复用浏览器实例，而不是每次 newPage() 都变慢
很多人以为 browser.newPage() 是轻量操作，其实它仍要初始化上下文、执行默认脚本、重置状态——频繁新建页等于反复冷启动。
- 一个
browser实例可长期持有，跨请求复用；别每次 HTTP 请求都launch()一次 - 用
browser.createIncognitoBrowserContext()隔离 session，比反复 launch+close 快得多 - 关闭页面用
page.close()，别用browser.close()；后者杀整个进程，再开成本极高 - 注意内存泄漏：每个
page的page.on('response', ...)监听器必须手动removeListener或用page.once
Pyppeteer 的 async/await 模型看着干净，但真正卡住你的从来不是语法，而是 Chromium 启动策略、页面生命周期判断时机、以及浏览器上下文复用粒度——这些地方一错，就从“自动化”变成“随机失败”。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
