Playwright浏览器关闭不生效是因默认启用后台进程复用且未禁用持久化模式，需确保所有退出路径执行browser.close()、配对context.close()，并优先使用sync_playwright()上下文管理器自动清理。
Playwright浏览器关闭不生效导致进程残留
直接调用 browser.close() 后，ps aux | grep chromium 仍能看到子进程在跑——这不是你代码没执行到关闭逻辑，而是 Playwright 默认启用后台进程复用（尤其是通过 playwright.chromium.launch() 启动时），且未显式禁用持久化模式。
常见诱因包括：使用了 launch_persistent_context、手动调用了 browser.new_context() 但忘了关 context、或在异常路径中跳过了 browser.close()。
- 务必确保
browser.close()在 所有退出路径（包括except和finally）中被执行 - 避免混用
launch()和launch_persistent_context()；后者返回的是BrowserContext，不是Browser，不能直接.close() - 若只需单次会话，显式传参
handle_sigint=False, handle_sigterm=False，防止信号被拦截干扰清理
用 context manager 确保 browser 实例自动释放
手动写 try/finally 容易漏，推荐用 playwright.sync_api.sync_playwright() 的上下文管理器。它会在退出时自动调用 playwright.stop()，进而终止所有关联浏览器进程。
注意：这个行为只对通过同一 playwright 实例启动的浏览器生效。多个 sync_playwright() 调用会创建独立实例，互不感知。
from playwright.sync_api import sync_playwright
<p>with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
page.goto("<a href="https://www.php.cn/link/b05edd78c294dcf6d960190bf5bde635">https://www.php.cn/link/b05edd78c294dcf6d960190bf5bde635</a>")</p><h1>不用手动 close —— exit with block 时自动清理</h1><p></p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac"><img
src="https://img.php.cn/upload/skill/001/246/273/6adaf20dbae7c507.jpg" alt="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" class="overflowclass">macOS UI 自动化技能包 —— 用 Python 控制你的 Mac</a>
<p class="overflowclass">让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript
系统要求
macOS 14+ (Sonoma)
Python 3.9+
需要开启：辅助功能 + 屏幕录制权限</p>
</div>
<a rel="nofollow" href="/xiazai/skill9965" title="macOS UI 自动化技能包 —— 用 Python 控制你的 Mac" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
- 不要在
with块外引用browser或page，否则可能触发 “Browser has been closed” 错误 - 异步场景用
async_playwright()+async with，原理相同 - 若需跨函数传递 browser，必须保证生命周期完全包裹在同一个
with块内
调试残留进程：如何快速定位哪个 browser 没关掉
当发现僵尸进程时，先确认是否真的没关——Playwright 启动时默认加了 --remote-debugging-port=0，端口是随机分配的。你可以通过 browser.contexts 和 context.pages 检查是否还有活跃页：
print(f"Active contexts: {len(browser.contexts)}")
for ctx in browser.contexts:
print(f" Pages in context: {len(ctx.pages())}")
- 如果
browser.contexts非空但没显式 close，说明 context 还活着，browser 就不会真正退出 - 每个
browser.new_context()都要配对context.close()，否则即使browser.close()被调用，底层进程也可能卡住 - Linux/macOS 下可用
lsof -i :<port></port>查看哪个进程占着调试端口，结合ps -o pid,ppid,cmd -ef追溯父进程
在 pytest 中集成 clean shutdown 的惯用写法
测试框架里最容易漏关浏览器，尤其 fixture 设计不当。推荐用 scope="session" + yield，并在 yield 后强制 close：
@pytest.fixture(scope="session")
def browser():
with sync_playwright() as p:
browser = p.chromium.launch(headless=True)
yield browser
# 此处 guaranteed 执行
browser.close() # 显式 close 更安心，尽管 with 也会做
- 避免用
scope="function"每次启停浏览器，开销大且易出竞态；session 级复用更稳 - 若测试中新建了
context或page，应在 test 函数内自行管理其生命周期，不要依赖 fixture 的 browser 自动清理 - CI 环境中建议加
timeout=30到launch()，防止 hang 住阻塞整个 pipeline
Playwright 的进程管理比 Selenium 更隐蔽，关键不在“有没有调 close”，而在于“是否所有 context/page 都已释放”以及“是否被多层上下文隔离了清理路径”。最稳妥的做法，永远是把 browser 创建和销毁锁死在同一个 with sync_playwright() 块里。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
