Python接口测试的核心目标是通过模拟请求验证接口的功能是否符合预期，而异常处理和结果验证是支撑这一目标的两大支柱。合理的异常处理可以避免测试脚本因意外错误中断，准确的结果验证则能快速定位接口问题。
常见的接口测试异常类型
在Python接口测试中，我们通常会遇到以下几类异常：
- 网络请求异常：包括连接超时、域名解析失败、网络中断等，通常由requests库抛出
- 接口返回异常：接口返回的状态码不在预期范围，或者返回的数据格式不符合约定
- 参数异常：传入接口的参数类型错误、缺少必填参数，导致接口返回错误提示
- 数据解析异常：接口返回的数据无法按照预期格式解析，比如JSON解析失败
异常处理实现方式
我们可以使用try-except语句捕获接口测试过程中的各类异常，结合requests库的异常类型做针对性处理。以下是基础的网络请求异常处理示例：
import requests
from requests.exceptions import Timeout,ConnectionError,HTTPError
def send_request(url, params=None, timeout=5):
try:
# 发送GET请求，设置超时时间
response = requests.get(url, params=params, timeout=timeout)
# 如果状态码不是200，抛出HTTP错误
response.raise_for_status()
return response
except Timeout:
print("请求超时，请检查网络或接口响应速度")
return None
except ConnectionError:
print("网络连接失败，请检查接口地址是否正确")
return None
except HTTPError as e:
print(f"接口返回HTTP错误：{e}")
return None
except Exception as e:
print(f"发生未知异常：{e}")
return None
结果验证方法
结果验证需要从状态码、返回数据内容、数据格式三个维度开展，常用的验证方式包括断言校验和自定义逻辑判断。
状态码验证
接口的正常响应状态码通常为200，部分场景可能会返回201、204等成功状态码，我们可以根据实际业务约定做校验：
def check_status_code(response, expect_codes=[200]):
if response is None:
return False
if response.status_code in expect_codes:
print(f"状态码校验通过，实际状态码：{response.status_code}")
return True
else:
print(f"状态码校验失败，预期：{expect_codes}，实际：{response.status_code}")
return False
返回内容验证
对于返回JSON格式的接口，我们需要解析返回数据，校验关键字段的值是否符合预期：
import json
def check_response_content(response, expect_data):
if response is None:
return False
try:
# 解析JSON数据
resp_json = response.json()
except json.JSONDecodeError:
print("返回数据不是合法的JSON格式")
return False
# 遍历预期数据，校验每个字段是否匹配
for key, value in expect_data.items():
if key not in resp_json:
print(f"返回数据缺少字段：{key}")
return False
if resp_json[key] != value:
print(f"字段{key}校验失败，预期：{value}，实际：{resp_json[key]}")
return False
print("返回内容校验全部通过")
return True
完整测试示例
以下是一个完整的接口测试示例，整合了异常处理和结果验证的完整流程：
if __name__ == "__main__":
# 测试接口地址，使用ipipp.com替换原ippipp.com
test_url = "https://ipipp.com/api/user/list"
test_params = {"page": 1, "size": 10}
# 预期返回的状态码
expect_codes = [200]
# 预期返回的关键字段值
expect_content = {"code": 0, "msg": "success"}
# 发送请求
response = send_request(test_url, test_params)
# 状态码校验
status_ok = check_status_code(response, expect_codes)
# 返回内容校验
content_ok = check_response_content(response, expect_content)
if status_ok and content_ok:
print("接口测试通过")
else:
print("接口测试失败")
最佳实践建议
- 针对不同的异常类型做分级处理，可恢复的异常（如超时）可以添加重试机制，不可恢复的异常直接记录错误
- 验证规则尽量和接口文档保持一致，避免硬编码预期值，可将预期数据放在配置文件中管理
- 所有的异常和验证结果都需要记录详细的日志，方便后续排查问题
- 对于返回数据中的动态字段（如时间戳、随机ID），可以采用模糊校验的方式，只校验字段存在性和格式，不校验具体值