无头 Chromium 在 ARM64 容器里跑 Web 自动化:5 个环境与稳定性坑位
背景
把浏览器自动化放进 ARM64(aarch64)Linux 容器后,最先崩的往往不是脚本逻辑,而是环境:Playwright 找不到匹配的浏览器二进制、headless 模式下渲染结果和预期不一致、导航瞬间读取 DOM 抛出 Execution context was destroyed。
这篇文章记录我在容器里跑端到端巡检时踩到的 5 个坑位,以及对应的排查路径和可复用写法。结论基于 Playwright + Chromium 153 + aarch64 环境实测。
坑位 1:Playwright 版本与浏览器 revision 不是一回事
报错通常长这样:
BrowserType.launch: Executable doesn't exist at
/root/.cache/ms-playwright/chromium_headless_shell-1243/chrome-headless-shell-linux-arm64/chrome-headless-shell
关键点:playwright install 下载的是当前 Python 包对应的 revision。如果容器镜像里预置的是 chromium-1243,而 headless shell 的 revision 是 1234,两者不会自动互相满足。
两条处理路径:
- 按提示补装:
playwright install chromium; - 直接使用镜像里已有的完整浏览器,通过
executable_path显式指定。
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(
headless=True,
executable_path="/root/.cache/ms-playwright/chromium-1243/chrome-linux/chrome",
args=["--no-sandbox", "--disable-dev-shm-usage"],
)
容器里 --no-sandbox 和 --disable-dev-shm-usage 基本是标配:前者绕开无特权的 user namespace,后者避免 /dev/shm 只有 64MB 时页面直接崩掉。
坑位 2:headless shell 不等于完整 Chromium
chrome-headless-shell 是精简外壳,体积小、启动快,但不支持扩展和部分媒体能力,字体回退路径也和完整浏览器不同。需要截图稳定、需要完整渲染行为时,应该用完整 chrome 二进制。
判断方法很直接:报错路径里出现 chrome-headless-shell,就说明当前走的是精简外壳。
坑位 3:152px 的二维码,手机扫不出来
截图默认按 CSS 像素输出。一个 152×152 的 <canvas> 截出来就是 152px,二维码模块被压得模糊,移动端识别率很低。
Playwright 的 device_scale_factor 乘在渲染层上,设成 3 之后同一个元素输出 456×456,扫码立刻变稳:
context = browser.new_context(device_scale_factor=3)
qr = page.query_selector("#qrcode")
qr.screenshot(path="qr.png") # 456×456
对需要移动端扫码的流程,这个参数比事后用 PIL 放大有效得多:放大只是插值,不会补回已经丢失的模块边界。
坑位 4:导航瞬间读取 DOM 的竞态
轮询页面状态时很容易撞到:
Error: Page.query_selector: Execution context was destroyed,
most likely because of a navigation
原因不是选择器写错,而是页面正在跳转,旧的 JS 执行上下文被销毁。正确做法是把「等待」和「读取」分开,并给轮询体做防御:
import time
def poll(page, check, timeout=600):
deadline = time.time() + timeout
while time.time() < deadline:
try:
if check(page):
return True
except Exception:
pass # 导航中断,本轮丢弃,下一轮重试
time.sleep(2)
return False
另外 goto 一律显式传 wait_until,不要依赖默认值:
domcontentloaded:结构可用,最快;load:等待子资源;networkidle:适合等接口静默,但单页应用的长连接会让它永远不 idle。
坑位 5:storage_state 是一把双刃剑
context.storage_state(path="state.json") 能把 Cookie 与 localStorage 落盘,下次用 new_context(storage_state=...) 直接复用登录态,省掉重复登录。
但要清楚它保存的是等效凭据:
- 文件按密钥对待:限制权限(如
chmod 600)、不要提交进仓库、不要放进公共构建缓存; - 有效期由站点决定,过期就重新走登录,不要尝试伪造;
- 多账号场景拆成多个 state 文件,避免串号。
小结
| 问题 | 症状 | 处理 |
|---|---|---|
| revision 不匹配 | Executable doesn’t exist | 显式 executable_path 或补装 |
| 精简外壳 | 渲染与能力缺失 | 使用完整 chrome 二进制 |
| 截图过小 | 移动端扫码失败 | device_scale_factor |
| 导航竞态 | context destroyed | 轮询内 try/except |
| 状态落盘 | 凭据泄露风险 | 文件权限 + 不入库 |
自动化脚本的稳定性,八成来自环境确定性与等待策略,而不是业务代码本身。先把这五个点钉死,再谈用例设计。
- 点赞
- 收藏
- 关注作者
评论(0)