---

前言

1、接口测试自动化好处

可以在短时间内自动执行大量的测试用例；
通过参数化和数据驱动的方式进行测试数据的变化，提高测试覆盖范围；

快速反馈测试执行结果和报告；
支持持续集成和持续交付的流程；

2、使用Python+Requests+Pytest+Allure搭建测试框架目的

简化接口测试编写：
Requests库是 Python 的一个优雅且简单的 Http库，可以很方便地发送 http 请求，接收和处理接口返回的响应数据。

强大的断言和校验功能：
Pytest 是一个功能强大的测试框架，提供丰富的断言功能，用于验证接口响应的正确性。

美观的测试报告：
Allure是一个开源的测试报告生成工具，可以生成漂亮、交互式和易于理解的测试报告。

持续集成：
使用Requests+Pytest+Allure搭建的框架可以与持续集成和自动化流程集成，实现快速的接口测试。

3、环境搭建

1）环境准备

安装requests、pytest、allure的方法

pip install requests
pip install pytest
pip install allure-pytest

requests、pytest 的安装很简单，这里主要讲讲如何安装 allure。

Windows 安装 allure：

①安装配置jdk这里就不再过多叙述。
②allure 命令行工具安装

allure命令行工具 allure是一个命令行工具，下载最新版。
地址：https://repo.maven.apache.org/maven2/io/qameta/allure/allure-commandline/

下载完成后，解压放在D盘

把bin目录添加到环境变量Path下

注意： cmd命令行运行 java、javac、allure可能表现安装未成功，出现这种情况时可以先选择重启试试。

3、接口自动化框架整体结构

名称	说明
api	api
config	配置文件，存放setting.ini配置文件，主要配置接口域名和mysql数据库信息
core	request 请求方法封装、关键字返回结果类
data	存放测试用例数据
log	日志
report	测试报告数据
testcase	测试方法
utils	工具类
pytest.ini	pytest 配置文件，为运行项目的相关参数
requirements.txt	相关依赖包及版本

测试代码运用了代码分层思想，具体往后看。

在testcases文件夹中，不做接口请求和返回值的操作，用一个方法A代替，参数为请求参数；

方法A中调用B方法，B方法接收组装好的参数（包含headers）；

B方法调用C方法，C方法接收请求参数，参数为接口路径（不包含域名）和 **kwargs（接收B方法中组装好的参数）C方法参数为url，接口请求参数： **kwargs；

4、测试用例

创建测试文件并编写测试方法

.py测试文件必须以“test ”开头（或“ test”结尾）；
测试方法必须以“test_”开头；
测试类必须以Test开头；

使用 Pytest 提供的装饰器 “@pytest.mark” 来标记测试用例，其中“@pytest.mark.parametrize ”用于参数化测试用例，通过装饰器可以将多个参数传递给测试函数。

@allure.feature(“”) 是Allure插件提供的一个装饰器，用于定义测试报告中的feature（敏捷开发场景）。

通过使用该装饰器，可以将测试用例按照功能模块进行分类展示，提供测试报告可读性。

如下是用户登录的一个例子，test_get_token 函数被标记为参数化测试用例，通过”@pytest.mark.parametrize“传递一个参数data和对应的值。

在测试函数中，可以直接使用传递的参数进行测试逻辑，验证请求接口返回是否通过，断言返回状态和登录令牌。

## test_user.py
@allure.feature("用户模块")
class TestUser:
    @pytest.mark.parametrize("data", get_data()['user_login'])
    @allure.story("登录-获得token")
    @allure.title("登录获取令牌测试用例")
    def test_get_token(self,data):
        result = login(data)
        assert result['body']['success'] is True
        assert len(result['body']['accessToken']) != 0 

5、发送请求和处理响应

调用requests库发送http请求，将data参数中的请求方式、参数和请求体通过调用 api_util_new.do_request()发送请求，使用response接收接口请求的响应结果，并将响应结果处理后返回。

def login(data):
    """
    获取令牌
    :param json_data
    :return:
    """
    response = client_api.do_request(url=data['url'], method=data['method'], json=data['data'])
    return process_response(response)

以下是对于接口请求响应结果的处理，使用字典ResultResponse存储处理后的response，检查请求响应状态代码以确定请求是否成功，并提取响应内容通过日志打印出来方便定位问题。

def process_response(response):
    ResultResponse = {}
    if response.status_code == 200 or response.status_code == 201:
        ResultResponse['success'] = True
        ResultResponse['body'] = response.json()
    else:
        ResultResponse['success'] = False
        logger.info("请求状态异常")
    logger.info("响应内容>>>：" + json.dumps(response.json(), ensure_ascii=False))
    return ResultResponse

封装 HTTP 请求的类 “RestClient”，在类方法 do_request() 中，使用 request() 方法接收接口url，接口请求 method 和可选的其他关键字参数。

在 request() 方法中，传入的 method（GET、POST、PUT、DELETE） ，使用 requests 库发送相应的 http 请求。

class RestClient:            
    def do_request(self, url, method,**kwargs):
        return self.request(url, method, **kwargs)     
    
    def request(self, url, method, **kwargs):
        if method == "GET":
            return requests.get(self.api_root_url + url, **kwargs)
        if method == "POST":
            return requests.post(self.api_root_url + url, **kwargs)
        if method == "PUT":
            return requests.put(self.api_root_url + url, **kwargs)
        if method == "DELETE":
            return requests.delete(self.api_root_url + url, **kwargs)

client_api = RestClient()

6、数据驱动测试和校验

通过 yaml 文件存放测试用例数据，如下user_login_body 为用户登录数据列表，其中url为api地址，method 为请求方式，data为请求参数

user_login_body:
  - url: /api/signin
    method: POST
    data: {
      username: user
      password: pwd
    }

json转yaml格式的方法网上一堆，比如 bejson，而校验 yaml 书写格式的工具，可以使用 YamlLint。

通过装饰器 @pytest.mark.parametrize，运行测试时会获取测试用例的数据去执行测试。

校验接口返回结果的正确性通常使用断言来实现。根据接口返回的数据结构，可以使用适当的断言函数来校验各个字段的值是否符合预期。

Pytest 支持使用 assert 关键字进行断言assert 函数，Pytest 提供了一些内置的断言函数

assertEqual(a, b)
assertTrue(x)
assertFalse(x)
assertIs(a, b)
assertIsNone(x)
assertIn(a, b)
assertNotIn(a, b)

7、报告生成展示

在命令行执行命令：pytest 运行用例后，会得到一个测试报告的原始文件，但这个时候还不能打开成HTML的报告，还需要在项目根目录下，执行命令启动 allure 服务。

下图是个结果测试结果的展示示例。

# 需要提前配置allure环境，才可以直接使用命令行
allure serve ./report

allure测试报告框架是一个开源的测试报告生成工具，它提供了丰富的功能和灵活的配置选项，用于生成美观、可交互和易于理解的测试报告。

基本过程如下：

框架集成：通过与 Pytest 集成 ，利用 Pytest 框架提供的插件机制，将测试结果和相关信息收集起来。

结果收集： allure 收集 Pytest 生成的测试结果数据，结果数据中包括测试用例的执行状态、断言结果、日志信息等。

报告生成： allure 使用收集到的数据转换为 xml 格式，并利用报告模板和样式表定义，渲染出漂亮的 html 文件。

8、持续集成

Jenkins中安装Allure插件 Allure Jenkins Plugin；
添加接口自动化测试的代码；
触发规则我选择的是准备发布打tag 后，自动执行构建；

cd ${WORKSPACE}
pytest

首先利用Python把HTTP接口封装成Python接口，接着把这些Python接口组装成一个个的关键字，再把关键字组装成测试用例，而测试数据则通过YAML文件进行统一管理，然后再通过Pytest测试执行器来运行这些脚本，并结合Allure输出测试报告。

下面是我整理的2023年最全的软件测试工程师学习知识架构体系图

一、Python编程入门到精通

二、接口自动化项目实战

三、Web自动化项目实战

四、App自动化项目实战

五、一线大厂简历

六、测试开发DevOps体系

七、常用自动化测试工具

八、JMeter性能测试

九、总结（尾部小惊喜）

在追逐梦想的路上，别怕困难与挫折，因为每一次的奋斗都是你成长的机会，只有坚持不懈，才能收获辉煌的人生。相信自己，勇往直前，成功属于你！

当你感到疲惫时，记得曾经的梦想和初心，它们将给你力量与勇气。不论困难多大，只要不放弃，努力奋斗，你一定能迎来辉煌的人生。相信自己，无所不能！

每一次的努力都是你成为更好版本的里程碑，每一次的坚持都是你追寻梦想的指南针。勇敢迈出步伐，战胜困难，终将看到自己的辉煌与成就。相信自己，奋斗不止！