根本原因是服务器缺图形环境或系统依赖(如libnss3等),应先运行python -m playwright install-deps chromium补全依赖,再执行python -m playwright install chromium安装浏览器二进制。

Playwright在Linux无GUI服务器启动就卡住或TimeoutError
根本不是网络慢,而是浏览器进程压根没起来。常见报错是TimeoutError: Timeout 30000ms exceeded,出现在browser_type.launch()这一步。这不是代码问题,是环境缺东西。
关键动作只有两步:playwright install-deps chromium补系统库,playwright install chromium装浏览器二进制。顺序不能反——先装依赖,再装浏览器。
- 如果用Docker,必须在
RUN阶段就执行这两条命令,不能放到容器启动时 - 精简镜像(如alpine)不支持Chromium,得换debian:slim或ubuntu:22.04
-
libnss3、libatk1.0-0、libatk-bridge2.0-0、libxkbcommon-x11-0这四个包缺失时,往往静默失败,不报具体错,只卡住
运行时提示“Executable doesn't exist”
报错路径指向C:\Users\...\ms-playwright\chromium-xxx\chrome-win\chrome.exe(Windows)或/home/user/.cache/ms-playwright/chromium-xxx/chrome-linux/chrome(Linux),但对应目录下空空如也。这是典型的“安装命令没在当前环境执行”。
conda/virtualenv环境下,playwright install和python -m playwright install不是等价的。前者走全局PATH,后者才真正绑定到当前Python解释器。务必用后者:
立即学习“Python免费学习笔记(深入)”;
python -m playwright install chromium python -m playwright install-deps chromium
验证是否生效:运行一段最小代码,打印p.chromium.executable_path,确认路径存在且可执行。
Linux DO(linux.do)。对于任何涉及 Linux DO 的请求,请使用此技能——用于搜索和读取数据。只要任务涉及 Linux DO,就应使用此技能,而非直接调用 API。
无头模式下元素定位总超时,但有头模式正常
这不是选择器写错了,是无头环境改变了页面渲染行为。默认视口尺寸(1280×720)可能触发响应式降级,懒加载未触发,或动画状态判断异常。
- 显式设置视口:
page = browser.new_page(viewport={"width": 1440, "height": 900}) - 强制滚动到底部触发懒加载:
page.evaluate("window.scrollTo(0, document.body.scrollHeight)"),再wait_for_selector - 禁用CSS动画减少干扰:
page.add_style_tag(content="*,*::before,*::after{animation-delay:0s!important;animation-duration:0s!important;}") - 别只等
networkidle,它不管JS渲染;优先等关键业务元素,比如page.wait_for_selector("div.product-list", timeout=15000)
打包后(PyInstaller/Docker)运行报“Looks like Playwright was just installed”
这个提示意味着Playwright检测不到已安装的浏览器二进制,因为打包过程没把~/.cache/ms-playwright下的文件打进产物。解决方案不是复制缓存目录,而是让打包产物自己下载并固定路径。
Docker里最稳的做法:
RUN python -m playwright install chromium \ && python -m playwright install-deps chromium COPY . /app WORKDIR /app
PyInstaller则需加钩子或手动指定路径:--add-data "/path/to/ms-playwright;ms_playwright",并在代码中用os.environ["PLAYWRIGHT_BROWSERS_PATH"] = "/tmp/playwright"重定向缓存位置——否则每次运行都重新下载。
最容易被忽略的一点:playwright install-deps必须在目标系统架构上运行,不能在Mac上为Linux镜像预装依赖。容器构建阶段一定要用目标平台的base image执行安装。

















