真实场景：一个登录接口的自动化测试

假设你正在学习接口测试，课程中给出的案例是测试一个电商系统的登录接口。低质量的课程可能只提供一段固定代码，而高质量的课程会引导你思考以下问题：

• ►接口返回的数据结构是怎样的？
• ►如何处理不同状态的响应（成功、失败、参数错误）？
• ►如何将测试数据与代码逻辑分离？

下面，我们用 Python 的 requests 库（v2.31.0）和 pytest（v7.4.0）来模拟一个标准化的解决路径。

问题拆解：从接口文档到可复用测试脚本

models.py

from dataclasses import dataclass

from typing import Optional

@dataclass

class LoginResponse:

"""登录接口响应模型"""

code: int

message: str

token: Optional[str] = None

user_id: Optional[int] = None

@classmethod

def from_dict(cls, data: dict):

return cls(

code=data.get('code', -1),

message=data.get('message', ''),

token=data.get('data', {}).get('token'),

user_id=data.get('data', {}).get('user_id')

)

**为什么这一步重要？**  
它强迫学习者理解接口返回结构，而不是直接拿字典取值。高质量的课程会强调「数据模型即文档」这一原则。

<div style="margin:24px 0;border:1px solid #E3F2FD;border-radius:8px;background:#FAFAFA;overflow:hidden;"><div style="display:flex;align-items:center;gap:12px;padding:12px 20px;background:linear-gradient(135deg,#E3F2FD,#BBDEFB);"><span style="width:36px;height:36px;background:#2196F3;color:#fff;border-radius:50%;display:inline-flex;align-items:center;justify-content:center;font-weight:bold;font-size:16px;flex-shrink:0;">2. </span><span style="font-size:17px;font-weight:700;color:#1565C0;">编写可配置的请求封装</span></div><div style="padding:16px 20px;"><p>接下来，将请求逻辑与测试数据解耦。课程应该展示如何通过配置文件管理 URL、超时时间等参数。</p></div></div>
# api_client.py
import requests
from config import BASE_URL, TIMEOUT  # 假设 config.py 中定义

def login(username: str, password: str) -> dict:
    """执行登录请求，返回原始响应字典"""
    url = f"{BASE_URL}/api/login"
    payload = {"username": username, "password": password}
    headers = {"Content-Type": "application/json"}
    
    try:
        response = requests.post(url, json=payload, headers=headers, timeout=TIMEOUT)
        response.raise_for_status()  # 非 2xx 状态码抛出异常
        return response.json()
    except requests.exceptions.RequestException as e:
        # 课程中应演示如何捕获并记录网络错误
        print(f"请求失败: {e}")
        return {"code": -1, "message": "网络异常"}

关键点：

• ►使用 raise_for_status() 明确处理 HTTP 错误。
• ►异常捕获后返回统一结构，便于后续断言。

test_login.py

import pytest

from models import LoginResponse

from api_client import login

class TestLogin:

"""登录接口测试套件"""

def test_login_success(self):

"""测试正常登录"""

response_data = login("test_user", "correct_password")

login_resp = LoginResponse.from_dict(response_data)

assert login_resp.code == 0, f"期望code=0，实际{login_resp.code}"

assert login_resp.token is not None, "登录成功应返回token"

assert len(login_resp.token) > 0, "token不应为空"

def test_login_wrong_password(self):

"""测试密码错误"""

response_data = login("test_user", "wrong_password")

login_resp = LoginResponse.from_dict(response_data)

assert login_resp.code == 1001, "密码错误应返回code 1001"

assert login_resp.token is None, "失败场景不应有token"

def test_login_empty_username(self):

"""测试用户名为空（边界值）"""

response_data = login("", "any_password")

login_resp = LoginResponse.from_dict(response_data)

assert login_resp.code == 1002, "空用户名应返回code 1002"

assert "用户名不能为空" in login_resp.message

**内容深度体现：**  
- 使用 `pytest` 的类组织用例，而非脚本式调用。  
- 每个用例包含明确的断言，而非仅打印结果。  
- 边界值（空字符串）测试是高质量课程的标配。

## 效果验证：运行测试并观察结果

执行 `pytest test_login.py -v`，输出应类似：

test_login.py::TestLogin::test_login_success PASSED

test_login.py::TestLogin::test_login_wrong_password PASSED

test_login.py::TestLogin::test_login_empty_username PASSED