Pytest接口自动化测试框架搭建模板

Python自动化测试框架与API接口测试实践

最新推荐文章于 2025-10-12 10:30:41 发布

原创

最新推荐文章于 2025-10-12 10:30:41 发布 · 2.9k 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#python #软件测试

本文介绍了使用Python的Pytest框架和Allure报告工具进行API接口自动化测试的详细步骤。项目结构清晰，包括API接口抽象、测试脚本、测试数据和配置文件。测试类基于Page Object模式，每个页面类包含了增删改查接口的实现。测试用例使用参数化，结合Allure装饰器提供丰富的测试报告。此外，还涉及到了日志管理和请求库session的使用。

auto_api_test

开发环境: Pycharm

开发语言&版本: python3.7.8

测试框架: Pytest、测试报告: Allure

项目源码Git地址

项目目录结构

api – 模仿PO模式, 抽象出页面类, 页面类内包含页面所包含所有接口, 并封装成方法可供其他模块直接调用
config – 配置文件目录
data – 测试数据目录
doc – 文档存放目录
log – 日志
report – 测试报告
scripts – 测试脚本存放目录
tools – 工具类目录
.gitignore – git忽略
app.py – 命令行启动入口
pytest.ini – pytest测试框架配置文件
README.md – 开发说明文档

代码分析

pytest.ini

pytest框架的配置文件

[pytest]
addopts = --html=../report/report.html    # pytest-html报告插件配置 
;addopts = -s --alluredir report    # allure-pytest报告插件配置
testpaths = ./scripts    # 设置用例目录识别名称
python_files = test*_*.py    # 设置测试文件识别名称
python_classes = Test*    # 设置测试类识别名称
python_functions = test_*    # 设置测试方法识别名称

app.py

# 基础路由(方便在部署环境发生变化时切换全局基础路由)
BASE_URL = "http://xxxx.com"
# 获取脚本的绝对路径(脚本在项目根目录就可以理解为项目路径)
ABS_PATH = os.path.abspath(__file__)
BASE_DIR = os.path.dirname(ABS_PATH)

# 命令行启动此脚本时执行测试用例
pytest.main(["scripts/"])

/config/config.json

配置文件, 目前包含全局请求头配置、类似全局变量的设置, 可通过tools内的工具函数进行读写
请求头具体参数根据需要自行配置

{
   
   
  "headers": {
   
   
    "Host": "xxx.com",
    "Connection": "keep-alive",
    "Accept": "application/json, text/plain, */*",
    "Authorization": "xxxx",
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36",
    "Content-Type": "application/json;charset=UTF-8",
    "Origin": "http://xxx.com"