无头浏览器自动化常见坑:从 Docker 沙箱到字体时区
汇总无头浏览器自动化在容器/CI 中的常见坑:沙箱参数、字体缺失、时区、视口与网络限制,避免「本地过、CI 挂」。
无头浏览器「本地好好的、上 CI 就崩」是高频现象。根因多是容器环境与本地差异。这份清单按命中率排。
1. 必须开沙箱参数。 Chromium 在 root/CI 里跑要加 --no-sandbox --disable-dev-shm-usage,否则「沙箱崩溃」直接报 FATAL。Docker 里 --disable-dev-shm-usage 还要配合加大 /dev/shm(默认 64MB 太小,页面一复杂就崩)。
2. 字体缺失。 容器里默认没中文字体,截图全是方块,甚至影响布局。基础镜像 RUN apt install fonts-noto-cjk,或把 CJK 字体挂进去。这是「截图测试乱码」的头号原因。
3. 时区。 CI 容器默认 UTC,本地可能是东八区。用例里若断言「今天日期」「当前时间」,跨时区就失败。统一设 TZ 或 mock 掉时间依赖。
4. 视口与 DPR。 不同断点用例要在 browser.newContext({viewport, deviceScaleFactor}) 里显式指定,别靠默认值,否则响应式断言在 CI 和本地不一致。
5. 网络限制。 容器网络常禁公网或限端口,page.goto 外网 404/超时。被测服务走本地/容器网络,第三方 API 走 Mock。
6. 冷启动慢。 浏览器进程拉起要 2-5s,用例多时复用 context、批量导航,别每条用例都重启浏览器。
落地:把 --no-sandbox、中文字体、/dev/shm、TZ 写进 CI 的浏览器镜像基线,绝大多数「本地过 CI 挂」就消失了。无头环境的核心是「和本地对齐」,先查环境差异再怀疑用例。
- 点赞
- 收藏
- 关注作者
评论(0)