在Docker容器中执行pytest无法生成HTML自动化测试报告求助

一、根因排查点 #

• 多阶段构建逻辑完全失效：Docker多阶段构建的规则是仅最后一个FROM定义的阶段会成为最终运行的镜像，前面阶段的所有运行时配置（包括CMD启动指令、环境变量、安装的运行依赖）都不会被带入最终镜像，只会通过COPY --from指令拷贝指定的静态文件。你当前的Dockerfile里，第一阶段设置的pytest启动命令，根本不会在最终的nginx容器里执行，自然不会触发测试、生成报告。
• 工作目录配置错误：WORKDIR .未指定绝对路径，python:3.9基础镜像默认工作目录为根路径/，后续COPY . .会将项目代码直接拷贝到根目录，导致pytest执行路径、报告生成路径混乱，甚至找不到测试文件。
• Chrome运行环境配置缺失：本地环境依赖桌面显示服务可正常运行Selenium，但容器内仅设置了ENV DISPLAY=:99，既未安装虚拟显示服务Xvfb，也未给Chrome配置无界面运行参数，Chrome进程会直接启动崩溃，pytest执行中断，无法走完报告生成流程。
• 文件路径错配：就算pytest正常执行生成了报告，当前流程也没有将报告文件拷贝到nginx静态目录的正确路径下，最终容器里根本不存在对应的report.html文件。

二、分场景修复方案 #

场景1：镜像构建时自动执行测试，生成静态报告部署到nginx #

该场景适合报告固定、不需要容器启动时重复执行测试的需求，核心是在构建阶段通过RUN指令执行pytest生成报告，再将报告拷贝到nginx静态目录：

1. 修正后的Dockerfile：

# 第一阶段：测试执行专用环境
FROM python:3.9 AS webautomation

# 安装Chrome依赖
RUN wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -
RUN sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list'
RUN apt-get -y update
RUN apt-get install -y google-chrome-stable xvfb

# 安装chromedriver
RUN apt-get install -yqq unzip
RUN wget -O /tmp/chromedriver.zip http://chromedriver.storage.googleapis.com/$(curl -sS chromedriver.storage.googleapis.com/LATEST_RELEASE)/chromedriver_linux64.zip
RUN unzip /tmp/chromedriver.zip chromedriver -d /usr/local/bin/

# 固定工作目录，避免路径混乱
WORKDIR /app

# 安装项目依赖
COPY requirements.txt .
RUN pip install -r requirements.txt

# 拷贝项目代码
COPY . .

# 构建阶段执行测试，通过xvfb-run提供虚拟显示服务，生成报告
RUN xvfb-run -a pytest --html=report.html tests/test_your_info_page.py

# 第二阶段：nginx部署环境
FROM nginx:alpine
# 仅将第一阶段生成的报告拷贝到nginx静态目录
COPY --from=webautomation /app/report.html /usr/share/nginx/html/report.html

2. 可选优化：不需要安装Xvfb的话，可直接在测试代码里给Chrome配置无界面参数，避免额外的系统依赖：

在test_your_info_page.py初始化Chrome驱动时增加配置：

from selenium.webdriver.chrome.options import Options
chrome_options = Options()
chrome_options.add_argument("--headless=new")
chrome_options.add_argument("--no-sandbox")
chrome_options.add_argument("--disable-dev-shm-usage")
driver = webdriver.Chrome(options=chrome_options)

此时构建阶段的pytest执行指令可直接去掉xvfb-run前缀。

场景2：容器启动时自动执行测试，每次启动生成最新报告 #

该场景适合需要每次启动容器都重新跑测试、生成最新报告的需求，核心是不要通过多阶段切割丢弃测试运行时环境，将测试执行、报告展示的依赖整合到同一镜像内：
修正后的Dockerfile示例：

FROM python:3.9
# 同时安装Chrome、chromedriver、nginx依赖
RUN wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -
RUN sh -c 'echo "deb [arch=amd64] http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list'
RUN apt-get -y update
RUN apt-get install -y google-chrome-stable nginx xvfb
RUN apt-get install -yqq unzip
RUN wget -O /tmp/chromedriver.zip http://chromedriver.storage.googleapis.com/$(curl -sS chromedriver.storage.googleapis.com/LATEST_RELEASE)/chromedriver_linux64.zip
RUN unzip /tmp/chromedriver.zip chromedriver -d /usr/local/bin/

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .

# 容器启动时先执行测试生成报告到nginx静态目录，再启动nginx服务
CMD xvfb-run -a pytest --html=/usr/share/nginx/html/report.html tests/test_your_info_page.py && nginx -g "daemon off;"

三、验证步骤 #

• 单独启动第一阶段的测试镜像，手动执行pytest命令，观察终端输出的报错信息：如果出现Chrome启动异常，就补全无界面参数或Xvfb配置；如果提示找不到测试文件，就检查工作目录和COPY的文件路径是否匹配。
• 确认pytest执行成功后，进入容器查看当前目录下是否真的生成了report.html，再核对该文件的绝对路径，确保和后续COPY的目标路径完全一致，避免路径错配。
• 明确区分RUN和CMD的执行时机：RUN指令在镜像构建阶段执行，CMD指令在容器启动时执行，多阶段构建中前置阶段的CMD不会自动在最终镜像中生效。

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