为何Selenium测试覆盖的Flask接口未被pytest-cov统计？

我有一个基于Flask的应用，用pytest搭建了简易测试环境，测试代码如下：

import subprocess
import time
import pytest
from selenium import webdriver
from selenium.webdriver.chrome.options import Options

@pytest.fixture()
def start_flask_app():
    # 启动Flask服务器并追踪覆盖率，让Selenium可以与之交互
    server = subprocess.Popen(['coverage', 'run', '--source', 'server', '-m', 'flask', 'run'])
    time.sleep(3)  # 等待服务器启动
    yield
    server.terminate()  # 测试结束后停止服务器

@pytest.fixture()
def driver(start_flask_app):
    options = Options()
    options.add_argument('--headless')
    options.add_argument('--disable-gpu')
    driver = webdriver.Chrome(options=options)
    yield driver
    driver.close()

def test_health_page(driver):
    """
    测试健康检查页面是否正常工作
    """
    driver.get('http://localhost:5000/health')
    assert 'UP' in driver.page_source

我执行pytest --cov=server命令运行测试，所有测试用例都通过了，但health路由并没有出现在覆盖率报告里。

这是什么原因？是否和pytest-cov的子进程支持有关？我尝试调整coveragerc配置但没解决问题。

当前使用的版本：

pytest==7.4.2
pytest-cov==4.1.0

核心原因 #

你现在的做法是在独立子进程里单独用coverage run收集服务器的覆盖率，但主进程的pytest --cov只会追踪测试代码本身的执行，两个进程的覆盖率数据完全独立，主进程不会自动合并子进程的结果，所以health路由的代码执行记录不会出现在最终报告里。

具体解决方法 #

要让子进程的覆盖率被主进程捕获并合并，需要通过覆盖率数据共享+合并实现，这里提供两种可行方案：

方案一：手动合并子进程覆盖率数据

1. 修改start_flask_app fixture，给子进程的覆盖率指定独立数据文件并启用并行模式：

   import os
   @pytest.fixture()
   def start_flask_app():
       env = os.environ.copy()
       # 指定子进程的覆盖率数据文件，避免和主进程冲突
       env['COVERAGE_FILE'] = '.coverage.server'
       server = subprocess.Popen(
           ['coverage', 'run', '--parallel-mode', '--source', 'server', '-m', 'flask', 'run'],
           env=env
       )
       time.sleep(3)
       yield
       server.terminate()
       # 等待子进程完全结束，确保覆盖率数据写入文件
       server.wait()
   

2. 执行测试后手动合并并生成报告：

   pytest --cov=server
   coverage combine
   coverage report
   

方案二：自动继承主进程覆盖率追踪（更简便）

利用coverage的环境变量让子进程自动继承主进程的覆盖率配置，无需手动启动coverage run：

1. 修改start_flask_app fixture，直接启动Flask并传递覆盖率配置：

   import os
   @pytest.fixture()
   def start_flask_app():
       env = os.environ.copy()
       # 让子进程加载coverage追踪器，读取coveragerc配置
       env['COVERAGE_PROCESS_START'] = '.coveragerc'
       server = subprocess.Popen(['python', '-m', 'flask', 'run'], env=env)
       time.sleep(3)
       yield
       server.terminate()
       server.wait()
   

2. 配置.coveragerc文件，开启并行模式：

   [run]
   source = server
   parallel = true
   

3. 直接执行测试，pytest-cov会自动合并子进程的覆盖率数据：

   pytest --cov=server --cov-report=term
   

关键说明 #

• Flask服务器运行在独立子进程中，主进程的覆盖率工具无法直接追踪其代码执行，必须通过共享配置或独立数据文件的方式收集子进程数据。
• --parallel-mode和COVERAGE_PROCESS_START是实现多进程覆盖率数据分离与合并的核心配置。

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