前言

Postman 仅适合单接口调试。面对批量回归、多环境验证和持续集成场景，手工操作效率极低且易出错。测试人员常常因为切换环境、维护大量请求而产生重复劳动，导致回归窗口被压缩、缺陷漏检。老实说，

这篇文章带你从零搭建一套公司级可落地的 Python + Pytest 接口自动化测试框架。覆盖接口封装、根据数据调整、报告可视化、CI/CD 集成全流程，可直接用于小型项目，也可平滑 至大型分布式程序。

技术选型与优势对比

我们选择以下技术栈，兼顾易用性、 性和环境成熟度：

标准化项目结构

采用分层设计思想将配置、接口、用例、工具、数据分离，保证框架的可维护性：

api_auto_test/
├── config/ # 环境配置目录
│ └── config.yaml # 多环境配置
├── api/ # 接口封装层
│ ├── __init__.py
│ └── login_api.py # 登录接口封装
├── testcases/ # 测试用例层
│ ├── __init__.py
│ └── test_login.py # 登录模块测试用例
├── utils/ # 工具层
│ ├── __init__.py
│ ├── request_util.py # HTTP 请求封装
│ ├── assert_util.py # 统一断言工具
│ └── log_util.py # 日志工具
├── data/ # 测试数据层
│ └── login_data.yaml # 登录模块测试数据
├── reports/ # 测试报告输出目录
├── requirements.txt # 项目依赖清单
└── pytest.ini # Pytest 全局配置文件

环境搭建与依赖安装

. 基础环境要求

• Python 3.8 及以上版本
• Pip 包管理工具
• 痛点：团队成员经常因为 Python 版本不一致导致依赖冲突，这里统一使用 pyenv 或 conda 管理。

. 安装依赖包

执行以下命令一键安装所有依赖：

pip install requests pytest pyyaml allure-pytest

. 生成依赖清单

方便后续团队协作和 CI 集成：

pip freeze> requirements.txt

主要模块实现

多环境配置管理 & 痛点缓解方案

在 config/config.yaml 中配置多环境信息，支持一键切换。这样可以彻底摆脱手动 URL 的低效做法。

# 环境配置：dev-开发环境 test-测试环境 prod-生产环境
active_env: "test"
env这方面，dev:
base_url: "https://dev-api.example.com"
timeout: 10
再看test，base_url: "https://api.example.com"
timeout: 10
再看prod，base_url: "https://prod-api.example.com"
timeout: 15

通用请求工具封装 & 提高异常日志

import requests
import yaml
import logging
import os
from typing import Dict,Any
# 配置日志 - 支持不同级别的输出，便于排查问题
logging.basicConfig(
level=logging.INFO,format="%s - %s - %s"
)
logger = logging.getLogger
class RequestUtil:
def __init__:
# 加载项目根目录下的 config.yaml，实现相对方法兼容 CI 环境
cfg_path = os.path.join,"..","config","config.yaml")
with open as f:
self.config = yaml.safe_load
self.active_env = self.config
env_cfg = self.config
self.base_url = env_cfg
self.timeout = env_cfg.get
def send_request(
self,method: str,path: str,headers: Dict = None,params: Dict = None,json: Dict = None,data: Any = None,**kwargs) -> requests.Response:
"""统一发送 HTTP 请求"""
url = self.base_url + path
logger.info
logger.info
说到try，resp = requests.request(
method=method,url=url,headers=headers,params=params,json=json,data=data,timeout=self.timeout。**kwargs)
logger.info
logger.debug: {resp.text}")
return resp
except requests.exceptions.Timeout:
logger.error
raise
except requests.exceptions.ConnectionError:
logger.error
raise
except Exception as e:
logger.error}")
raise

业务接口层封装 & “每个接口一个方法”原则

from utils.request_util import RequestUtil
class LoginApi:
def __init__:
self.request = RequestUtil
def login:
"""登录接口"""
path = "/api/v1/login"
payload = {"username": username,"password": password}
return self.request.send_request

根据数据调整——测试数据与脚本分离

- casename: 正常登录-正确使用者名密码
username: "test01"
password: "pwd123"
expectstatus: 200
expectcode: 0
expectmsg: "登录成功"

• casename: 登录失败-使用者名不存在 username: "nonexist" password: "" expectstatus: 404 expectcode: 1002 expectmsg: "使用者不存在"

• casename: 登录失败-使用者名为空 username: "" password:"" expectstatus :400

  expect_code :1003

[

**

Now continue with test case implementation...

Sorry for confusion;let's move on.

Now final part:

Okay let's proceed.

...

* End of file *