1. 项目概述从“连不上”到“稳如狗”的Playwright实战心法如果你正在用Playwright做自动化测试或者网页抓取大概率已经踩过或者即将踩进“连接失败”这个坑里。浏览器启动不了、页面加载超时、元素定位不到……这些问题背后十有八九是连接问题在作祟。我见过不少团队花几天时间写的脚本跑起来却像抽奖时好时坏最后只能归咎于“网络不稳定”或者“环境玄学”。实际上绝大多数连接问题都有明确的成因和解决方案。这个项目就是把我过去几年在Web自动化一线趟过的雷、填过的坑系统性地梳理出来聚焦于“解决Playwright连接问题”这个核心痛点并分享一套经过大规模生产验证的最佳实践。无论你是刚入门的新手还是在复杂项目中挣扎的资深开发者这里的内容都能帮你把Playwright从“能用”变成“好用且可靠”。2. 连接问题的根源深度剖析与分类Playwright的连接问题表象千奇百怪但根源往往集中在几个关键环节。不理解这些就像看病不知道病因只能胡乱吃药。2.1 浏览器启动与进程管理问题这是最经典的一类问题错误信息通常包含browserType.launch、executable doesn‘t exist或Failed to launch。核心原因1浏览器二进制文件缺失或损坏。Playwright的一大优势是能自动下载所需的浏览器Chromium, Firefox, WebKit。但这个自动下载过程可能因为网络问题、权限问题或磁盘空间不足而失败。更隐蔽的情况是下载不完整文件损坏导致启动时崩溃。注意很多人以为playwright install执行完就万事大吉但命令行没有报错并不代表所有文件都100%正确下载。特别是在使用公司内网代理或跨境网络时部分文件可能下载超时被静默跳过。核心原因2浏览器进程残留。这是导致“端口占用”或“无法连接到浏览器”的常见原因。如果你的脚本异常退出比如未处理的Promise拒绝、进程被强制杀死浏览器进程可能没有正确关闭继续在后台运行。下次启动时Playwright尝试连接同一个用户数据目录或端口就会冲突。核心原因3资源限制。操作系统对进程数、文件描述符或内存的限制。在Docker容器内或低配服务器上运行尤其容易触发。浏览器本身是资源消耗大户如果系统ulimit设置过低可能无法fork出新的浏览器进程。2.2 网络连接与代理配置问题Playwright脚本需要与浏览器进程通信通过WebSocket或管道浏览器进程需要访问目标网页。这两层连接都可能出问题。核心原因1本地环回地址与端口冲突。Playwright启动浏览器后会开启一个调试端口默认随机。如果该端口被其他应用占用或者系统的localhost127.0.0.1解析有问题在某些特殊的网络或Docker配置下连接就会失败。核心原因2系统或应用层代理干扰。这是企业开发环境中最头疼的问题之一。你的机器可能配置了全局HTTP/HTTPS代理。Playwright的Node.js/Python运行时和它启动的浏览器进程继承或不继承这些代理设置的行为非常微妙。浏览器可能会尝试通过代理去连接localhost:9222导致根本无法连接到自己的调试端口。核心原因3防火墙与安全软件拦截。特别是Windows Defender或第三方杀毒软件可能会将Playwright启动的陌生浏览器实例尤其是Chromium的无头模式识别为可疑行为从而阻止其网络连接或直接终止进程。2.3 超时设置与异步操作问题错误信息常伴随TimeoutError发生在page.goto()、page.waitForSelector()或browser.newContext()等操作。核心原因1默认超时时间与业务场景不匹配。Playwright的默认超时通常是30秒对于常规网页足够但对于加载大量资源的复杂单页应用SPA、或网络缓慢的环境就显得捉襟见肘。盲目地设置一个很大的超时如5分钟也不是好办法它会掩盖真正的问题让脚本在卡死时等待过久。核心原因2页面加载状态判断失误。page.goto(url)的waitUntil选项默认为load即加载事件。但对于大量使用JavaScript动态渲染的现代Web应用如React, Vue, Angularload事件触发时DOM可能远未准备好。你需要根据实际页面行为选择domcontentloaded、networkidle或自定义等待逻辑。核心原因3异步操作未正确等待。这是编程模式问题。例如你启动了一个导航但没等它完成就去点击页面上的元素或者你发起多个并行操作但没有妥善处理它们之间的竞争条件。在Playwright的异步API世界里“忘记await”是万恶之源。2.4 环境与依赖兼容性问题核心原因1Node.js/Python版本不兼容。Playwright对运行时版本有要求。使用过旧或过新的Node.js版本可能会遇到原生模块native addons编译失败或API不兼容的问题。核心原因2操作系统依赖库缺失。尤其是在Linux服务器上运行无头浏览器时。Chromium需要一系列共享库如libnss3,libatk-bridge2.0等。如果系统是精简版这些库可能不存在。核心原因3Playwright版本与浏览器版本不匹配。虽然Playwright设计上会管理浏览器版本但如果你通过某些手段如手动指定浏览器路径使用了不兼容的版本就会引发各种难以预料的连接和行为异常。3. 系统性诊断与排查实战指南当连接问题发生时不要盲目重试。按照以下步骤像侦探一样层层排查可以快速定位问题根源。3.1 第一步启用详细日志与追踪Playwright提供了强大的日志功能这是诊断的第一把钥匙。在启动时传入DEBUG环境变量或配置launchOptions。对于Node.js# 方法1启用Playwright核心调试日志 DEBUGpw:api,pw:browser,pw:protocol node your_script.js # 方法2在代码中启用追踪并输出到文件 const { chromium } require(playwright); (async () { const browser await chromium.launch({ headless: false, // 首次排查时建议先看有头模式 slowMo: 500, // 慢动作方便观察 }); const context await browser.newContext(); // 启动追踪 await context.tracing.start({ screenshots: true, snapshots: true }); const page await context.newPage(); try { await page.goto(https://example.com); // ... 你的操作 } finally { // 保存追踪文件 await context.tracing.stop({ path: trace.zip }); await browser.close(); } })();保存下来的trace.zip可以用Playwright的内置追踪查看器playwright show-trace trace.zip打开它能以时间线的形式完整回放脚本执行过程包括网络请求、DOM快照、控制台日志是分析超时和异常的无价之宝。对于Pythonimport os os.environ[“DEBUG”] “pw:api,pw:browser” # 或者通过 launch 参数 browser await chromium.launch(headlessFalse, slow_mo500)3.2 第二步隔离环境最小化复现创建一个最简单的、只包含问题核心的脚本。例如一个只做browser.launch()和page.goto(‘http://localhost’)的脚本。这能帮你判断问题是出在Playwright基础环境上还是你的复杂业务逻辑或页面交互上。最小化复现脚本示例const { chromium } require(playwright); (async () { console.log(Attempting to launch browser...); const browser await chromium.launch({ headless: false }); console.log(Browser launched successfully.); const page await browser.newPage(); console.log(Navigating to page...); const response await page.goto(https://www.google.com, { timeout: 60000 }); console.log(Navigation status: ${response.status()}); await page.screenshot({ path: test.png }); console.log(Screenshot taken.); await browser.close(); console.log(Test completed.); })().catch(err { console.error(FATAL ERROR:, err); process.exit(1); });运行这个脚本。如果它成功了说明你的Playwright基础安装和网络是通的问题可能出在更复杂的场景如特定网站、认证、代理。如果它失败了错误信息会给你最直接的线索。3.3 第三步检查网络与代理配置如果怀疑是代理问题可以在启动浏览器时显式地传递代理设置或者告诉浏览器绕过代理。在代码中配置代理const browser await chromium.launch({ proxy: { server: http://myproxy.com:8080, // 你的代理服务器 bypass: localhost,127.0.0.1, // 重要避免代理到本地调试端口 username: user, // 如果需要认证 password: pass } });更彻底的方法在启动参数中传递环境变量。对于Chromium你可以通过args传递Chromium本身的命令行标志来忽略系统代理const browser await chromium.launch({ args: [--no-proxy-server, --ignore-certificate-errors] // 忽略代理和证书错误用于测试 });同时检查你的系统环境变量HTTP_PROXY、HTTPS_PROXY、NO_PROXY。在运行Playwright脚本时可以尝试临时清空它们unset HTTP_PROXY HTTPS_PROXY NO_PROXY # 在Windows CMD中: set HTTP_PROXY # 在Windows PowerShell中: $env:HTTP_PROXY “”3.4 第四步验证浏览器二进制与依赖运行Playwright自带的检查命令npx playwright install --dry-run这个命令会检查所有需要的浏览器是否已安装且完整。如果提示缺失再运行npx playwright install进行安装。对于下载慢的问题Playwright允许配置下载镜像源。可以设置环境变量来加速# 使用国内镜像源示例具体镜像地址需查找可用的 PLAYWRIGHT_DOWNLOAD_HOSThttps://npmmirror.com/mirrors/playwright npx playwright install chromium在Linux上如果遇到启动崩溃可能是依赖库缺失。使用系统包管理器安装常见依赖# Ubuntu/Debian sudo apt-get install -y libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 libgbm1 libasound2 # CentOS/RHEL sudo yum install -y alsa-lib atk at-spi2-atk cups-libs gtk3 libXcomposite libXdamage libXrandr mesa-libgbm nss4. 连接问题的最佳实践与防御性编程解决了已知问题更重要的是建立一套实践预防未来出现问题。以下是我总结的、能极大提升连接稳定性的最佳实践。4.1 实践一健壮的浏览器生命周期管理浏览器的启动和关闭必须可靠。推荐使用try...catch...finally模式并考虑使用自动重试机制。基础健壮模板const MAX_RETRIES 3; let browser null; let retryCount 0; async function launchBrowserWithRetry() { while (retryCount MAX_RETRIES) { try { console.log(Launch attempt ${retryCount 1}); // 每次重试使用全新的启动选项避免残留状态影响 browser await chromium.launch({ headless: true, timeout: 30000, // 启动超时设置 // 强制使用新的用户数据目录避免旧数据冲突 args: [--no-sandbox, --disable-dev-shm-usage, --user-data-dir/tmp/playwright- Date.now()] }); console.log(Browser launched successfully.); return browser; } catch (launchError) { retryCount; console.error(Launch failed on attempt ${retryCount}:, launchError.message); if (retryCount MAX_RETRIES) { throw new Error(Failed to launch browser after ${MAX_RETRIES} attempts: ${launchError.message}); } // 等待一段时间再重试避免瞬时问题 await new Promise(resolve setTimeout(resolve, 2000 * retryCount)); // 强制清理可能残留的进程此处为Unix示例Windows需调整 try { require(child_process).execSync(pkill -f chromium); } catch(e) {} } } } async function runTask() { try { browser await launchBrowserWithRetry(); const context await browser.newContext(); const page await context.newPage(); // ... 你的业务逻辑 } catch (error) { console.error(Task execution failed:, error); // 这里可以加入错误上报逻辑 } finally { // 确保浏览器被关闭即使任务中途出错 if (browser browser.isConnected()) { await browser.close().catch(e console.warn(Error closing browser:, e)); } } }4.2 实践二智能超时与等待策略不要使用统一的全局超时。应该根据操作类型和业务重要性设置分级的超时策略。分层超时配置示例const TIMEOUT_CONFIG { BROWSER_LAUNCH: 60000, // 浏览器启动60秒 PAGE_NAVIGATION: 45000, // 页面导航45秒 NETWORK_IDLE: 30000, // 网络空闲30秒 ACTION_CLICK: 15000, // 点击等交互15秒 ASSERTION: 10000, // 断言10秒 SHORT_POLL: 2000, // 短轮询2秒 }; async function navigateWithSmartWait(page, url) { // 主要导航等待较长时间 const navigationPromise page.goto(url, { waitUntil: domcontentloaded, timeout: TIMEOUT_CONFIG.PAGE_NAVIGATION }); // 同时等待一个关键元素出现作为页面“可交互”的标志 const criticalElementPromise page.waitForSelector(#app-root, { state: attached, timeout: TIMEOUT_CONFIG.PAGE_NAVIGATION }).catch(() null); // 即使关键元素没出现也不立刻失败 await Promise.race([ navigationPromise, new Promise((_, reject) setTimeout(() reject(new Error(Navigation to ${url} timed out)), TIMEOUT_CONFIG.PAGE_NAVIGATION)) ]); // 导航基本完成后再等待网络相对空闲针对SPA try { await page.waitForLoadState(networkidle, { timeout: TIMEOUT_CONFIG.NETWORK_IDLE }); } catch (e) { console.warn(Page did not reach networkidle state, but continuing...); } // 最后检查关键元素 if (!(await criticalElementPromise)) { console.warn(Critical element not found after navigation.); } }对于动态内容page.waitForSelector是基础但更高级的做法是使用page.waitForFunction等待自定义的JavaScript条件成立这比单纯等待一个选择器更可靠。// 等待直到某个特定条件满足例如某个全局变量被设置或某个元素具有特定属性 await page.waitForFunction(() { const appState window.myApp?.state; return appState READY || appState LOADED; }, { timeout: TIMEOUT_CONFIG.ASSERTION }); // 等待直到列表项数量大于0且不再变化针对动态加载列表 await page.waitForFunction(() { const initialCount document.querySelectorAll(.list-item).length; if (initialCount 0) return false; // 给一点时间看数量是否稳定 return new Promise(resolve { setTimeout(() { const newCount document.querySelectorAll(.list-item).length; resolve(newCount initialCount); }, 1000); }); }, { timeout: 30000 });4.3 实践三上下文Context与页面Page的隔离策略不要所有任务都共享同一个浏览器上下文Context或页面Page。上下文隔离能带来诸多好处Cookie/Storage隔离避免测试数据相互污染。权限隔离如地理位置、通知权限的设置互不影响。稳定性提升一个页面的崩溃不会轻易波及其他页面。并行能力可以轻松实现多页面并行操作。推荐模式为每个独立任务创建新的Context。async function runIndependentTask(browser, taskData) { // 为每个任务创建独立的上下文模拟完全独立的用户会话 const context await browser.newContext({ viewport: { width: 1920, height: 1080 }, userAgent: My Custom Bot/1.0, // 可以预设Cookie // cookies: [...], // 忽略HTTPS错误仅测试环境 ignoreHTTPSErrors: true, }); // 监听上下文内的所有请求和响应便于调试 context.on(request, request console.log( ${request.method()} ${request.url()})); context.on(response, response console.log( ${response.status()} ${response.url()})); const page await context.newPage(); try { await performTask(page, taskData); } finally { // 任务完成关闭上下文自动清理其中的所有页面 await context.close(); } }4.4 实践四全面的错误处理与状态恢复Playwright操作失败时抛出的错误对象包含丰富信息要善加利用。精细化错误捕获与恢复async function safeClick(page, selector, options {}) { const maxAttempts options.maxAttempts || 2; for (let attempt 1; attempt maxAttempts; attempt) { try { await page.click(selector, { timeout: options.timeout || 10000 }); console.log(Clicked ${selector} successfully on attempt ${attempt}); return; // 成功则退出函数 } catch (clickError) { console.warn(Click attempt ${attempt} failed for ${selector}:, clickError.message); if (attempt maxAttempts) { throw new Error(Failed to click ${selector} after ${maxAttempts} attempts: ${clickError.message}); } // 根据错误类型采取不同恢复策略 if (clickError.message.includes(Timeout) || clickError.message.includes(detached)) { // 可能是元素未出现或DOM已更新尝试重新查找 console.log(Element might be stale or not ready, retrying after a short wait...); await page.waitForTimeout(1000 * attempt); // 递增等待 } else if (clickError.message.includes(not visible)) { // 元素不可见尝试滚动到视图中 await page.evaluate(selector document.querySelector(selector)?.scrollIntoView(), selector); await page.waitForTimeout(500); } else { // 其他未知错误直接重试 await page.waitForTimeout(500); } } } }实现一个全局的“安全网”监听器捕获未处理的页面崩溃或断开连接page.on(crash, () { console.error(Page crashed!); // 触发恢复逻辑例如重启浏览器或记录错误 }); page.on(close, () { console.log(Page closed.); }); context.on(close, () { console.log(Context closed.); });5. 高级场景下的连接优化与技巧当你的脚本需要在CI/CD流水线、Docker容器或处理极其复杂的单页应用SPA中运行时需要更高级的技巧。5.1 在CI/CD与Docker中稳定运行容器化环境资源受限且通常是无头的。以下配置经过大量生产验证Dockerfile关键步骤# 使用官方提供的包含依赖的镜像这是最稳妥的方式 FROM mcr.microsoft.com/playwright:v1.40.0-focal # 或者如果你基于普通镜像必须安装系统依赖 # FROM node:18-slim # RUN apt-get update apt-get install -y \ # libnss3 libatk-bridge2.0-0 libdrm2 libxkbcommon0 libgbm1 libasound2 \ # rm -rf /var/lib/apt/lists/* WORKDIR /app COPY package*.json ./ RUN npm ci --onlyproduction # 使用ci确保依赖锁一致 COPY . . CMD [“node”, “index.js”]启动浏览器的优化参数适用于Docker/无头环境const browser await chromium.launch({ headless: true, // CI环境必须为true args: [ --no-sandbox, // 在容器内必须否则可能启动失败 --disable-setuid-sandbox, --disable-dev-shm-usage, // 限制使用/dev/shm避免内存不足 --disable-accelerated-2d-canvas, --disable-gpu, // 无头模式下GPU无用 --single-process, // 在某些资源极受限环境可考虑但稳定性稍降 --disable-software-rasterizer, --disable-background-timer-throttling, --disable-backgrounding-occluded-windows, --disable-renderer-backgrounding, --window-size1920,1080 ], // 限制浏览器进程资源 timeout: 60000, // 在内存紧张的机器上可以尝试禁用一些功能 // ignoreDefaultArgs: [--disable-extensions], });5.2 处理认证、Cookie与会话持久化对于需要登录的网站避免每次运行都重新登录。可以持久化用户状态Cookie、LocalStorage。保存和加载用户状态const fs require(fs).promises; const path require(path); const STATE_FILE path.join(__dirname, user-state.json); async function loginAndSaveState(page) { await page.goto(https://example.com/login); await page.fill(#username, myuser); await page.fill(#password, mypass); await page.click(#submit); await page.waitForURL(**/dashboard); // 保存当前上下文状态包含cookies, localStorage等 const state await page.context().storageState(); await fs.writeFile(STATE_FILE, JSON.stringify(state)); console.log(Login state saved.); } async function getLoggedInContext(browser) { let context; try { // 尝试加载已保存的状态 const state JSON.parse(await fs.readFile(STATE_FILE, utf-8)); context await browser.newContext({ storageState: state }); console.log(Loaded existing login state.); } catch (error) { // 文件不存在或无效创建新上下文并登录 console.log(No valid state found, performing fresh login...); context await browser.newContext(); const page await context.newPage(); await loginAndSaveState(page); await page.close(); } return context; } // 使用方式 const browser await chromium.launch(); const loggedInContext await getLoggedInContext(browser); const page await loggedInContext.newPage(); await page.goto(https://example.com/dashboard); // 应该已经是登录状态5.3 应对动态内容与反自动化检测现代网站大量使用动态内容并可能部署反爬虫或反自动化检测。Playwright提供了强大的模拟真实用户行为的能力来应对。策略1模拟人类操作模式。避免过于规律和快速的点击。引入随机延迟和移动轨迹。async function humanLikeClick(page, selector) { const element await page.waitForSelector(selector); const box await element.boundingBox(); // 计算元素中心点 const x box.x box.width / 2; const y box.y box.height / 2; // 模拟人类鼠标移动先快速移动到大体位置再慢速微调 await page.mouse.move(x - 50, y - 50, { steps: 5 }); // 快速移动 await page.waitForTimeout(100 Math.random() * 200); // 随机停顿 await page.mouse.move(x, y, { steps: 20 }); // 慢速精确移动 await page.waitForTimeout(50 Math.random() * 150); await page.mouse.down(); await page.waitForTimeout(30 Math.random() * 70); await page.mouse.up(); } // 随机滚动页面模拟浏览行为 async function randomScroll(page) { const scrollHeight await page.evaluate(() document.body.scrollHeight); const viewportHeight await page.evaluate(() window.innerHeight); const randomScrollTo Math.floor(Math.random() * (scrollHeight - viewportHeight)); await page.evaluate((y) window.scrollTo({ top: y, behavior: smooth }), randomScrollTo); await page.waitForTimeout(500 Math.random() * 1500); }策略2使用真实的用户代理和视口。避免使用默认的HeadlessChrome UA。const context await browser.newContext({ viewport: { width: 1366, height: 768 }, // 常见分辨率 userAgent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36, // 真实Chrome UA locale: zh-CN, // 设置语言 timezoneId: Asia/Shanghai, // 设置时区 });策略3注入真实浏览器的特征。一些网站通过检测navigator.webdriver等属性来识别自动化工具。Playwright默认会将其设为true但你可以通过CDPChrome DevTools Protocol会话尝试修改注意此方法可能随浏览器版本更新而失效且可能违反某些网站的服务条款请谨慎评估使用。const context await browser.newContext(); const page await context.newPage(); // 通过CDP会话执行JavaScript修改或隐藏某些属性 const cdpSession await page.context().newCDPSession(page); await cdpSession.send(Page.addScriptToEvaluateOnNewDocument, { source: Object.defineProperty(navigator, webdriver, { get: () undefined }); Object.defineProperty(navigator, plugins, { get: () [1, 2, 3, 4, 5] }); Object.defineProperty(navigator, languages, { get: () [zh-CN, zh, en] }); });6. 性能调优与资源管理当脚本需要长时间运行或处理大量页面时性能与资源泄露会成为新的“连接”问题表现为内存耗尽、进程僵死。6.1 监控与诊断性能瓶颈使用Node.js的内置工具或Playwright的追踪功能来定位问题。监听性能指标const { chromium, devices } require(playwright); const fs require(fs); (async () { const browser await chromium.launch(); const context await browser.newContext(); const page await context.newPage(); // 监听性能指标 page.on(load, async () { const metrics await page.evaluate(() JSON.stringify({ timing: performance.timing, memory: performance.memory, // 注意performance.memory 仅限Chrome navigation: performance.getEntriesByType(navigation)[0] })); console.log(Page metrics:, metrics); }); // 或者使用更专业的Performance API获取更详细的时间线 const client await page.context().newCDPSession(page); await client.send(Performance.enable); client.on(Performance.metrics, (metrics) { console.log(Metrics:, metrics.metrics); }); await page.goto(https://example.com); await browser.close(); })();6.2 预防内存泄漏确保及时清理不再使用的页面、上下文和浏览器。常见内存泄漏模式及修复// 错误模式不断创建新页面但不关闭 async function leakyFunction(browser) { for (let i 0; i 100; i) { const page await browser.newPage(); // 每次循环都创建新页面 await page.goto(...); // 操作页面... // 忘记 page.close()! 页面对象会一直留在内存中。 } } // 正确模式及时清理 async function correctFunction(browser) { for (let i 0; i 100; i) { const page await browser.newPage(); try { await page.goto(...); // 操作页面... } finally { await page.close(); // 确保页面被关闭 } } } // 对于并行任务使用Promise.all但要管理好生命周期 async function parallelTasks(browser, urls) { const tasks urls.map(async (url) { // 为每个任务创建独立的上下文实现完全隔离 const context await browser.newContext(); const page await context.newPage(); try { await page.goto(url); const data await page.evaluate(() document.title); return { url, data }; } finally { // 任务完成立即清理自己的上下文和页面 await context.close(); } }); const results await Promise.allSettled(tasks); // 使用allSettled避免一个失败导致全部失败 return results.filter(r r.status fulfilled).map(r r.value); }6.3 连接池与复用策略对于高频次、短生命周期的任务反复启动和关闭浏览器开销巨大。可以考虑实现一个简单的浏览器连接池。简易浏览器连接池示例class BrowserPool { constructor(maxSize 5) { this.maxSize maxSize; this.pool []; // 存放可用的浏览器实例 this.activeCount 0; // 正在使用的实例数 this.waitingQueue []; // 等待获取浏览器的请求队列 } async acquire() { // 如果池中有可用实例且未超过最大活跃数直接返回 if (this.pool.length 0 this.activeCount this.maxSize) { this.activeCount; return this.pool.pop(); } // 如果还可以创建新实例 if (this.activeCount this.maxSize) { this.activeCount; console.log(Creating new browser instance...); return await chromium.launch({ headless: true }); } // 否则加入等待队列直到有资源释放 console.log(Pool exhausted, waiting for free browser...); return new Promise((resolve) { this.waitingQueue.push(resolve); }); } async release(browser) { // 检查浏览器是否还健康 if (browser browser.isConnected()) { // 如果有等待者直接把浏览器给等待者 if (this.waitingQueue.length 0) { const nextResolve this.waitingQueue.shift(); nextResolve(browser); } else { // 否则放回池中 this.pool.push(browser); } } else { // 浏览器不健康关闭它并减少活跃计数 if (browser) await browser.close().catch(() {}); this.activeCount--; // 如果因为浏览器损坏导致活跃数减少且有待处理请求尝试创建新的 if (this.waitingQueue.length 0 this.activeCount this.maxSize) { this.activeCount; const nextResolve this.waitingQueue.shift(); nextResolve(await chromium.launch({ headless: true })); } } } async destroy() { for (const browser of this.pool) { await browser.close().catch(() {}); } this.pool []; this.activeCount 0; } } // 使用连接池 const pool new BrowserPool(3); async function taskUsingPool(url) { const browser await pool.acquire(); const page await browser.newPage(); try { await page.goto(url); // ... 处理任务 return await page.title(); } finally { // 关闭页面但将浏览器实例归还给池 await page.close(); await pool.release(browser); } }这套实践下来你的Playwright脚本在面对复杂的网络环境、不稳定的目标网站以及长时间的运行压力时连接稳定性和整体健壮性都会有质的飞跃。记住稳定的自动化不是一蹴而就的它建立在每一个细节的妥善处理之上。从今天起告别随机的连接失败让你的脚本在任何环境下都值得信赖。