ccf接口测试实战

一、比赛题目

练习赛-测试人网站搜索接口自动化测试 - 霍格沃兹测试开发学社 / 霍格沃兹测试学院教务处 - 爱测-测试人社区

二、分析题目

一、题目解析

✅ 核心任务：

使用 Python 编写接口自动化测试脚本，对 https://ceshiren.com/search 接口进行全面测试，并打包成 .zip 文件提交。

🔍 题目关键信息提取：

🧩 二、你应该怎么做？（分步指导）

✅ 第一步：理解接口行为

访问这个页面： 👉 https://ceshiren.com/search?expanded=true

这是「高级搜索」界面，你可以输入关键词、选择分类等。

但注意：接口层面目前只提供了 q 参数作为主要搜索字段。

你可以手动测试几个请求：

# 示例请求
GET https://ceshiren.com/search?q=pytest&limit=10

返回的是 JSON 格式数据，包含：

• posts: 匹配的帖子列表（搜索结果应为空列表，表示没有找到相关内容，不传page，post不为空）
• topics: 匹配的话题
• groups: 匹配的群组
• users: 匹配的用户
• grouped_search_result: 聚合结果（不传参数时，缺少q，搜索关键词为空，响应不应包含 grouped_search_resul
  ）

✅ 第二步：设计测试用例（等价类 + 边界值）

📋 测试用例表

✅ 第三步：满足评分标准（非常重要！）

这是你拿高分的关键，必须逐项满足：

🏗️ 三、推荐架构：使用 PO（Page Object）设计模式

虽然这是接口测试，但也可以用 API 层的 PO 模式 来组织代码。

📁 项目结构建议：

三、代码

1.线性版本（简化版）

import pytest
import requests


class TestCeshirenSearch:

    def setup_class(self):
        self.base_url = "https://ceshiren.com"
        # 搜索接口 url
        self.search_url = f"{self.base_url}/search"

    # 正向用例
    @pytest.mark.parametrize(
        "search_key",
        [
            "pytest",
            "面试题",
            "a",
            "appium desktop连接真机，start session，出现报错，手机上appium setting打开闪退，但是进程显示是进行中。报错内容：An unknown server-side error occurred while processing the command. Original error: Could not find a connected Android device in 20364ms.",
        ]
    )
    def test_search(self, search_key):
        params = {
            "q": search_key,
            "page": 1
        }
        headers = {
            "Accept": "application/json"
        }
        r = requests.request(method="GET", url=self.search_url, params=params, headers=headers)
        print(r.text)
        results = len(r.json().get("posts"))
        print(f"响应结果中 posts 结果数量为 {results}")
        assert results != 0

    # 搜索关键词为空
    def test_search_none(self):
        params = {
            "q": "",
            "page": 1
        }
        headers = {
            "Accept": "application/json"
        }
        r = requests.request(method="GET", url=self.search_url, params=params, headers=headers)
        print(r.text)
        assert r.json().get("grouped_search_result") == None

    # 搜索结果为空
    def test_search_no_result(self):
        params = {
            "q": "ooooooooooo",
            "page": 1
        }
        headers = {
            "Accept": "application/json"
        }
        r = requests.request(method="GET", url=self.search_url, params=params, headers=headers)
        print(r.text)
        assert r.json().get("posts") == []

    # 缺少请求参数 q
    def test_search_noq(self):
        params = {
            "page": 1
        }
        headers = {
            "Accept": "application/json"
        }
        r = requests.request(method="GET", url=self.search_url, params=params, headers=headers)
        print(r.text)
        assert r.json().get("grouped_search_result") == None

    # 缺少请求参数 page
    def test_search_nopage(self):
        params = {
            "q": "测试用例"
        }
        headers = {
            "Accept": "application/json"
        }
        r = requests.request(method="GET", url=self.search_url, params=params, headers=headers)
        print(r.text)
        results = len(r.json().get("posts"))
        print(f"响应结果中 posts 结果数量为 {results}")
        assert results != 0

    # 不传请求参数
    def test_search_noparams(self):
        headers = {
            "Accept": "application/json"
        }
        r = requests.request(method="GET", url=self.search_url, headers=headers)
        print(r.text)
        assert r.json().get("grouped_search_result") == None

✅ 整体优点总结

⚠️ 潜在问题与改进建议

1. ❌ 缺少异常处理（健壮性不足）

当前代码未捕获网络异常或 JSON 解析错误，可能导致测试崩溃。

✅ 改进建议：

import requests
from requests.exceptions import RequestException
import json

try:
    r = requests.get(...)
    r.raise_for_status()  # 检查 HTTP 状态码
    json_data = r.json()
except RequestException as e:
    pytest.fail(f"请求失败: {e}")
except json.JSONDecodeError:
    pytest.fail("响应不是合法的 JSON")

2. ❌ 断言不够精确（部分场景）

assert r.json().get("grouped_search_result") == None

更推荐使用 is None 判断：

assert r.json().get("grouped_search_result") is None

.get() 返回 None 是明确的空值，应使用 is 而非 ==。

3. ❌ 缺少对 HTTP 状态码的校验

接口可能返回 404 或 500，但代码只解析 JSON，容易误判。

assert r.status_code == 200

4. ❌ print(r.text) 不适合 CI/CD 环境

在自动化流水线中，print 输出不易管理。

import logging
logging.basicConfig(level=logging.INFO)
logging.info(r.text)

或者使用 pytest 的 -s 结合 logging。

5. ✅ 可增加更多边界测试（建议扩展）

目前覆盖不错，但仍可补充：

6. ✅ 可引入 fixture 优化重复代码

当前每个方法都重复定义 headers 和 requests.get。

@pytest.fixture
def client(self):
    session = requests.Session()
    session.headers.update({"Accept": "application/json"})
    return session

def test_search(self, client, search_key):
    params = {"q": search_key, "page": 1}
    r = client.get(self.search_url, params=params)
    ...

7. ✅ 建议添加接口响应时间监控（性能维度）

assert r.elapsed.total_seconds() < 2  # 响应时间小于 2 秒

优化版本

import pytest
import requests
import time


class TestCeshirenSearch:
    def setup_class(self):
        self.base_url = "https://ceshiren.com"
        self.search_url = self.base_url + "/search"

    @pytest.fixture
    def client(self):
        """封装请求客户端，复用 headers 和 session"""
        session = requests.Session()
        session.headers.update({"Accept": "application/json"})
        return session

    @pytest.mark.parametrize(
        "search_key",
        [
            "pytest",
            "面试题",
            "a",
            "appium desktop连接真机，start session，出现报错，手机上appium setting打开闪退",
        ]
    )
    def test_search(self, search_key, client):
        params = {"q": search_key, "page": 1}

        # 添加延迟，避免触发限流
        time.sleep(1)

        # 发送请求
        r = client.get(self.search_url, params=params, timeout=10)

        # 新增：显式断言状态码为 200
        assert r.status_code == 200, f"HTTP 状态码错误: {r.status_code}"
        # 或者也可以保留 r.raise_for_status()，但你明确要求用 assert，所以用 assert

        json_data = r.json()
        assert "posts" in json_data, "响应缺少 posts 字段"

        results = len(json_data["posts"])
        print(f"关键词 '{search_key}' 的搜索结果数: {results}")
        assert results > 0, f"搜索 '{search_key}' 未返回结果"

    def test_search_empty_keyword(self, client):
        """测试空关键词搜索"""
        params = {"q": "", "page": 1}
        r = client.get(self.search_url, params=params, timeout=10)
        assert r.status_code == 200
        json_data = r.json()
        # Discourse 在 q="" 时不会返回 grouped_search_result
        assert json_data.get("grouped_search_result") is None
        

    def test_search_no_results(self, client):
        """测试无结果的关键词"""
        params = {"q": "nonexistentkeyword12345", "page": 1}
        r = client.get(self.search_url, params=params, timeout=10)
        assert r.status_code == 200
        json_data = r.json()
        assert len(json_data["posts"]) == 0

2.po设计模式 

预告