当前位置：首页 > news >正文

openEuler测试工具API自动化测试实战：从零开始构建测试框架

news 2026/7/18 8:04:15

openEuler测试工具API自动化测试实战：从零开始构建测试框架

【免费下载链接】test-toolsThe repo contains tools for improve test efficiency项目地址: https://gitcode.com/openeuler/test-tools

前往项目官网免费下载：https://ar.openeuler.org/ar/

想要提升openEuler系统测试效率吗？openEuler测试工具提供了完整的API自动化测试解决方案，让您能够快速构建稳定可靠的测试框架。本文将带您深入了解如何利用openEuler测试工具进行API自动化测试实战，掌握从环境搭建到测试执行的完整流程。

openEuler测试工具是一个专门为提升测试效率而设计的开源项目，它集成了多种自动化测试框架和工具，帮助开发者和测试工程师快速构建、执行和管理API测试。无论您是测试新手还是经验丰富的专业人士，都能通过本文掌握openEuler测试工具的核心功能和使用技巧。

🚀 为什么选择openEuler测试工具进行API自动化测试？

1. 完整的测试生态

openEuler测试工具提供了从单元测试到集成测试的完整解决方案，特别在API测试方面有着丰富的实践经验。项目中的Aops_Auto_Test目录包含了完整的API自动化测试框架，支持多种测试场景。

2. 模块化设计

测试框架采用清晰的模块化设计，将配置管理、请求处理、断言验证等功能分离，便于维护和扩展。核心模块包括：

配置管理：config/conf.yaml - 统一管理测试环境配置
请求封装：utils/RequestsUtil.py - 封装HTTP请求操作
API接口：api/ - 定义各业务模块的API接口
测试用例：test_case/ - 组织具体的测试用例

3. 灵活的测试数据管理

通过YAML文件管理测试数据，实现测试数据与测试逻辑的分离。例如，查询应用列表的测试数据存储在test_data/aops-diana/query_app_list.yaml中，便于维护和复用。

openEuler测试工具API自动化测试框架架构图

🔧 快速搭建API自动化测试环境

第一步：克隆项目仓库

git clone https://gitcode.com/openeuler/test-tools cd test-tools/Aops_Auto_Test/Aops_Api_Auto_Test

第二步：配置测试环境

编辑配置文件config/conf.yaml，设置您的测试环境参数：

BASE: log_level: info test: url: http://your-test-server username: admin password: your-password

第三步：安装依赖

pip install -r requirements.txt

📊 API自动化测试框架核心组件详解

1. 请求处理模块

utils/RequestsUtil.py是整个框架的核心，封装了HTTP请求的所有操作：

class Request: def requests_api(self, url, params=None, json=None, files=None, headers=None, cookies=None, method="get"): # 支持GET、POST、DELETE等多种HTTP方法 if method == "get": res = requests.get(url, json=json, params=params, headers=headers, cookies=cookies) elif method == "post": res = requests.post(url, json=json, data=params, files=files, headers=headers, cookies=cookies, timeout=120) # ... 其他方法实现

2. API接口封装

每个业务模块都有对应的API封装类，如aops_diana.py：

class ApiDiana: def __init__(self): # 自动获取认证token url = ConfigYaml().get_conf_url() + ':80/api/manage/account/login' data = {"username": ConfigYaml().get_user(), "password": ConfigYaml().get_login_password()} res = Request().post(url=url, json=data) token_access = res["body"]["data"]['token'] def query_app_list(self, params): headers = {'Content-Type': 'application/json', 'Access-Token': token} url = ConfigYaml().get_conf_url() + ":11112/check/app/list" return Request().get(url=url, params=params, headers=headers)

3. 测试用例编写

测试用例采用pytest框架，结构清晰易懂。以test_query_app_list.py为例：

class TestQueryAppList: @pytest.mark.parametrize('test_data', Yaml(data_file).data()) def test_query_app_list(self, test_data): test_data = Yaml(conf.get_common_yaml_path()).replace_yaml(test_data) res = ApiDiana().query_app_list(test_data["data"]) assert_res = AssertUtil() assert_res.assert_data(res, test_data["validate"])

API自动化测试执行流程图

🎯 实战：编写您的第一个API测试用例

场景：测试应用列表查询功能

步骤1：准备测试数据在test_data/aops-diana/目录下创建query_app_list.yaml：

- name: 查询应用列表-正常场景 data: page: 1 per_page: 10 validate: code: 200 body.code: 200 body.msg: success - name: 查询应用列表-分页测试 data: page: 2 per_page: 5 validate: code: 200 body.code: 200

步骤2：编写测试用例在test_case/aops-diana/目录下创建test_query_app_list.py：

import pytest from Aops_Api_Auto_Test.api.aops_diana import ApiDiana from Aops_Api_Auto_Test.utils.AssertUtil import AssertUtil class TestQueryAppList: def test_query_app_list_normal(self): """测试正常查询应用列表""" params = {"page": 1, "per_page": 10} res = ApiDiana().query_app_list(params) # 断言验证 assert res["code"] == 200 assert res["body"]["code"] == 200 assert res["body"]["msg"] == "success" assert "data" in res["body"]

步骤3：执行测试

cd Aops_Auto_Test/Aops_Api_Auto_Test python -m pytest test_case/aops-diana/test_query_app_list.py -v

API测试结果统计展示

🔍 高级功能：参数化测试与数据驱动

参数化测试

openEuler测试工具支持强大的参数化测试功能，通过@pytest.mark.parametrize装饰器实现：

@pytest.mark.parametrize('page, per_page, expected_code', [ (1, 10, 200), (0, 10, 400), # 测试异常情况 (1, 0, 400), (1, 101, 400), # 测试边界值 ]) def test_query_app_list_with_params(self, page, per_page, expected_code): params = {"page": page, "per_page": per_page} res = ApiDiana().query_app_list(params) assert res["code"] == expected_code

数据驱动测试

通过YAML文件管理测试数据，实现数据与代码分离：

# test_data/query_app_list_cases.yaml test_cases: - name: "正常分页查询" input: page: 1 per_page: 10 expected: code: 200 has_data: true - name: "超出范围的分页" input: page: 1000 per_page: 10 expected: code: 200 data_count: 0

📈 测试报告与持续集成

生成HTML测试报告

openEuler测试工具支持生成详细的HTML测试报告：

python -m pytest test_case/ --html=./report/test_report.html --self-contained-html

集成到CI/CD流程

将API自动化测试集成到您的CI/CD流水线中：

# .gitlab-ci.yml 示例 stages: - test api_test: stage: test script: - cd Aops_Auto_Test/Aops_Api_Auto_Test - pip install -r requirements.txt - python -m pytest test_case/ --junitxml=report.xml artifacts: when: always paths: - Aops_Auto_Test/Aops_Api_Auto_Test/report.xml

API测试覆盖率报告示例

🛠️ 最佳实践与优化建议

1. 测试用例组织

按业务模块组织测试用例目录结构
使用有意义的测试用例命名
保持测试用例的独立性

2. 错误处理与重试机制

在utils/RequestsUtil.py中添加重试逻辑：

import time from requests.exceptions import RequestException class Request: def requests_api_with_retry(self, url, max_retries=3, **kwargs): for attempt in range(max_retries): try: return self.requests_api(url, **kwargs) except RequestException as e: if attempt == max_retries - 1: raise time.sleep(2 ** attempt) # 指数退避

3. 性能测试集成

结合性能测试工具，监控API响应时间：

import time def test_api_performance(self): start_time = time.time() res = ApiDiana().query_app_list({"page": 1, "per_page": 10}) end_time = time.time() assert res["code"] == 200 assert (end_time - start_time) < 2.0 # 响应时间应小于2秒