CI环境下Robot Framework Browser测试配置与报错求助

配置信息 #

Dockerfile片段 #

FROM ubuntu:22.04

RUN curl -fsSL https://deb.nodesource.com/setup_20.x | bash \
    && apt-get update && apt-get install -y nodejs

克隆私有GitHub仓库 #

RUN mkdir -p /home/sampleTest && cd /home/sampleTest
RUN git clone ...

设置工作目录 #

WORKDIR /TEST/

安装Python依赖并配置环境 #

RUN python3.8 -m venv venv
ENV PATH="/TEST/venv/bin:$PATH"
ENV PYTHONPATH=/TEST/config ...
RUN pip3 install --no-cache-dir --upgrade pip wheel && \
  pip3 --version && \
  pip3 install --no-cache-dir --upgrade robotframework robotframework-browser==14.1. && \
  python3 -m Browser.entry init

遇到的报错 #

运行测试时出现错误：

Initializing library 'Browser' with no arguments failed: TypeError: Formatter() takes no arguments

尝试执行PLAYWRIGHT_BROWSERS_PATH=TEST/pw-browsers npx playwright install设置自定义浏览器路径后，仍出现相同报错。

疑问 #

• rfbrowser init的完整性：在Dockerfile中仅使用rfbrowser init是否足以在CI环境中完成浏览器配置，是否需要额外步骤？
• 方案可行性：直接在Docker镜像中通过rfbrowser init安装浏览器，是否适合CI环境下运行Robot Framework Browser测试？
• 报错解析：能否解释rfbrowser init过程中出现的TypeError: Formatter() takes no arguments错误？该错误是否与缺失配置步骤或版本不兼容有关？

说明 #

我了解存在预安装浏览器的Robot基础镜像选项，但因使用较旧版本的Robot，该方案不适用。

问题解答 #

1. rfbrowser init的完整性 #

仅用python3 -m Browser.entry init（即rfbrowser init）在CI环境里不够完整，需要补充以下步骤：

• 安装系统底层依赖：Ubuntu 22.04需安装Playwright运行必需的系统库，执行：

  apt-get install -y --no-install-recommends libnss3 libatk1.0-0 libatk-bridge2.0-0 libcups2 libdrm2 libxkbcommon0 libxcomposite1 libxdamage1 libxfixes3 libxrandr2 libgbm1 libasound2
  

• 补全浏览器依赖：init完成后加一句npx playwright install --with-deps，强制补全浏览器及配套依赖，避免网络波动导致安装不完整。
• 配置权限：确保CI运行测试的用户拥有浏览器安装目录的访问权限，防止启动时报权限错误。

2. 方案可行性 #

直接在Docker镜像中通过rfbrowser init安装浏览器完全适合CI环境，但要注意几个优化点：

• 分层构建：将依赖安装、浏览器安装、代码克隆拆分为独立Docker层，代码变更时无需重复安装依赖和浏览器，缩短构建时间。
• 缓存浏览器：将Playwright浏览器目录挂载为CI缓存卷，或指定固定安装目录配合CI缓存机制复用，减少重复下载耗时。
• 无头模式运行：CI无图形界面，测试时必须指定浏览器以无头模式启动，比如在Robot用例中添加Open Browser ${URL} chromium headless=True。

3. 报错解析 #

TypeError: Formatter() takes no arguments错误主要由版本不兼容导致：

• 版本号格式错误：你安装的robotframework-browser==14.1.结尾多了一个点，实际应指定完整版本号（如14.1.0），否则可能安装到不符合预期的版本。
• Robot Framework版本不匹配：Robot Framework Browser 14.x要求Robot Framework至少为6.1版本，若你使用的旧版本Robot低于这个要求，就会触发这类兼容性错误。
• Python与依赖冲突：Python3.8和部分新版本依赖可能存在兼容性问题，导致Formatter类初始化失败。建议执行pip freeze检查依赖版本，确认robotframework与robotframework-browser版本匹配。

解决办法：要么升级Robot Framework到符合要求的版本，要么降级robotframework-browser到与现有Robot版本兼容的版本（比如Robot 5.x对应Browser 10.x系列，需参考官方兼容性矩阵），同时修正版本号格式。

内容的提问来源于stack exchange，提问作者John Snow