11.3 · 测试基础设施（Testing Infrastructure）

复杂文档理解与引用检索 · 本章是 RAGFlow DeepWiki 中文译文的独立章节页，保留原始链接、源码锚点、模块标签和章节层级。

项目RAGFlow 章节11.3 状态全文译文模块测试、发布与运维、安装与启动、界面与交互、模型调用与提供方适配

项目要点页2.5 参考项目项目章节目录RAGFlow DeepWiki 原始章节Testing Infrastructure 上一章11.2 下一章11.4

源码线索

.github/workflows/release.yml
.github/workflows/tests.yml
Dockerfile
Dockerfile.deps
api/apps/restful_apis/user_api.py
docker/docker-compose-base.yml
docker/infinity_conf.toml
download_deps.py
helm/values.yaml
pyproject.toml

模块标签

测试、发布与运维
安装与启动
界面与交互
模型调用与提供方适配
系统架构

中文译文

测试基础设施（中文译文）

原始 DeepWiki 页面：https://deepwiki.com/infiniflow/ragflow/11.3-testing-infrastructure

翻译时间：2026-05-27T08:44:46.955Z

翻译模型：deepseek-chat

原文字符数：12649

项目：RAGFlow (ragflow)

---

测试基础设施

测试套件组织

测试套件根据其目标接口以及在请求生命周期中的位置，分为几个不同的层级。

类别	位置	目的	关键工具
SDK 测试	`test/testcases/test_sdk_api/`	验证 Python SDK 客户端逻辑及其与服务器的交互。	`ragflow-sdk`, `pytest`
HTTP API 测试	`test/testcases/test_http_api/`	通过 `requests` 直接测试 RESTful API 端点。	`requests`, `pytest`, `hypothesis`
Web API 测试	`test/testcases/test_web_api/`	测试 React 前端使用的内部 API。	`requests`, `pytest`
SDK 单元测试	`sdk/python/test/`	验证特定 SDK 组件和客户端逻辑。	`pytest`, `requests`
Playwright 端到端测试	`test/playwright/`	基于浏览器的应用程序端到端测试。	`pytest-playwright`
单元测试	`test/unit_test/`	测试独立的业务逻辑和工具函数。	`pytest`

测试中的系统数据流

下图说明了不同类型的测试如何与 RAGFlow 生态系统交互，将自然语言测试定义桥接到代码实体。

测试接口架构

graph TD
    subgraph "测试运行器"
        SDK_T["SDK 测试 (test/testcases/test_sdk_api/)"]
        HTTP_T["HTTP API 测试 (test/testcases/test_http_api/)"]
        WEB_T["Web API 测试 (test/testcases/test_web_api/)"]
        PW_T["Playwright 端到端测试 (test/playwright/)"]
    end

    subgraph "代码实体"
        SDK_C["ragflow_sdk.DataSet (sdk/python/pyproject.toml)"]
        SVR["ragflow_server.py (api/ragflow_server.py)"]
        WEB_AUTH["RAGFlowWebApiAuth (test/testcases/test_web_api/conftest.py)"]
        HTTP_AUTH["RAGFlowHttpApiAuth (test/testcases/test_http_api/conftest.py)"]
    end

    subgraph "后端服务"
        MYSQL["MySQL (docker/docker-compose-base.yml)"]
        DS["文档存储: Infinity/ES/OpenSearch (docker/docker-compose-base.yml)"]
        REDIS["Valkey/Redis (docker/docker-compose-base.yml)"]
        SANDBOX["沙箱执行器 (docker/docker-compose-base.yml)"]
    end

    SDK_T --> SDK_C
    SDK_C --> SVR
    HTTP_T --> HTTP_AUTH
    HTTP_AUTH --> SVR
    WEB_T --> WEB_AUTH
    WEB_AUTH --> SVR
    PW_T --> SVR
    SVR --> MYSQL
    SVR --> DS
    SVR --> REDIS
    SVR --> SANDBOX

来源： sdk/python/pyproject.toml:1-4, docker/docker-compose-base.yml:72-146, docker/docker-compose-base.yml:148-174, docker/docker-compose-base.yml:225-231, pyproject.toml:170-186

测试配置与持续集成集成

RAGFlow 利用 pytest 的夹具（fixtures）、标记（markers）和 GitHub Actions 来管理状态并在不同环境中确定执行优先级。

Pytest 标记与优先级

测试套件使用优先级标记对测试进行分类，这些标记在 SDK 和主测试配置中定义：

@pytest.mark.p1：关键/高优先级功能测试，例如基本数据集创建或文档上传 sdk/python/pyproject.toml:28-28。
@pytest.mark.p2：中等优先级测试，涵盖边界条件和标准工作流 sdk/python/pyproject.toml:29-29。
@pytest.mark.p3：低优先级或边缘情况测试，包括长时间运行或非关键路径测试 sdk/python/pyproject.toml:30-30。

持续集成（CI）

GitHub Actions 工作流 tests.yml 自动化了测试过程。它处理以下事项：

环境设置：使用 uv 构建 Go 服务器和 Python 环境 pyproject.toml:188-199。
容器化：构建 ragflow:nightly 镜像 Dockerfile:134-150。
执行矩阵：根据环境配置，针对不同的文档引擎（Infinity、Elasticsearch、OpenSearch）运行测试 helm/values.yaml:14-21。
静态分析：运行 Ruff 进行代码风格检查和格式化检查 .github/workflows/tests.yml:94-98。

来源： sdk/python/pyproject.toml:26-31, .github/workflows/tests.yml:132-150, pyproject.toml:188-199, helm/values.yaml:14-21

专项测试场景

SDK 和 HTTP API 测试

SDK 和 HTTP API 测试确保外部集成的稳定性。

文件管理：test/testcases/test_http_api/test_file_management_within_dataset/ 中的测试验证了文档生命周期操作，例如 parse_documents、stop_parse_documents 和 delete_documents。
基于属性的测试：使用 Hypothesis 生成多样化的输入数据，以测试 API 的健壮性 pyproject.toml:171-171。

Playwright 端到端测试

test/playwright/ 中的基于浏览器的测试模拟了真实的用户交互：

认证流程：验证注册和登录成功 test/playwright/auth/test_register_then_login_flow.py。
应用工作流：测试聊天会话（test_next_apps_chat.py）、代理执行（test_next_apps_agent.py）和知识库搜索（test_next_apps_search.py）。
模型提供商设置：验证与智谱AI等大语言模型（LLM）提供商的集成 test/playwright/e2e/test_model_providers_zhipu_ai_defaults.py。

来源： pyproject.toml:171-171, pyproject.toml:184-184, test/playwright/e2e/test_next_apps_chat.py:1-1, test/playwright/e2e/test_next_apps_agent.py:1-1

测试基础设施组件

测试环境依赖于与生产环境相同的基础设施，并通过 Docker Compose 进行本地开发编排。

基础设施组件映射

graph LR
    subgraph "测试执行空间"
        PYTEST["Pytest 运行器 (pyproject.toml)"]
        PW["Playwright (test/playwright/conftest.py)"]
    end

    subgraph "服务实体"
        MYSQL_S["MySQL 8.0 (docker/docker-compose-base.yml:178)"]
        REDIS_S["Valkey 8 (docker/docker-compose-base.yml:227)"]
        MINIO_S["MinIO (docker/docker-compose-base.yml:205)"]
        INF_S["Infinity (docker/docker-compose-base.yml:75)"]
        SAND_S["沙箱管理器 (docker/docker-compose-base.yml:151)"]
    end

    PYTEST --> MYSQL_S
    PYTEST --> REDIS_S
    PYTEST --> MINIO_S
    PYTEST --> INF_S
    PW --> SAND_S

测试依赖管理

测试依赖项在单独的组中进行管理，以保持生产镜像的精简：

Python 库：pytest、hypothesis、pytest-playwright 和 pytest-cov 在 test 依赖组中定义 pyproject.toml:170-186。
外部二进制文件：Dockerfile 包含安装 chrome-linux64 和 chromedriver 的逻辑，以支持 Playwright 和 Selenium 测试 Dockerfile:116-123。
模拟数据：测试使用在构建过程中下载的 nltk_data 和特定模型快照（DeepDoc）download_deps.py:74-77。

来源： pyproject.toml:170-186, Dockerfile:116-123, download_deps.py:74-77, docker/docker-compose-base.yml:1-231