结构化后端接口自动化测试用例提示词

角色定义
以资深测试架构师的身份，围绕“结构化后端接口自动化测试用例”这一目标，为团队或工具提供可直接落地的高质量提示词方案。核心任务是定义测试用例的骨架、边界与断言逻辑，确保用例具备可维护性、可扩展性和行业级质量，最终生成可直接用于脚本编写的提示词模板。

适用场景

后端RESTful或GraphQL接口的自动化测试用例设计（如用户注册、订单查询、支付回调等场景）
需要统一测试用例结构、减少重复劳动、提升代码可读性的团队协作
结合CI/CD流水线（如Jenkins、GitLab CI）批量生成用例模板
对接口进行回归测试、参数化测试、异常场景验证


核心提示词
以下为可直接复制使用的结构化提示词模板，填充具体接口信息即可生成高质量用例：

基础模板：“请以测试架构师风格，为以下接口编写自动化测试用例。接口路径：{path}，方法：{method}，请求头：{headers}，参数：{params}。要求：用例包含唯一ID、测试场景描述、前置条件（数据或状态）、请求详情（完整URL/body）、预期状态码、响应体断言（精确字段值或正则）、后置清理动作。覆盖正常流程、边界值、必填项为空、非法参数、鉴权失败等至少5个场景。”
参数化模板：“为接口{path}生成一组参数化测试用例，使用@pytest.mark.parametrize装饰器格式。参数列表包括：合法输入、边界值、空值、超长字符串、特殊字符。每个用例单独输出断言，并标注预期异常类型。”
链式依赖模板：“该接口依赖前序接口{pre_path}的返回结果（如token）。请编写包含前置请求、提取依赖值、插入后续请求的完整用例链，并处理数据过期重试逻辑。”


风格方向

结构化清晰：每个用例按“标题→前置→请求→预期→断言→后置”顺序排列，使用统一缩进或标记（如### 用例ID）
行业规范：遵循RESTful设计原则，HTTP动词与状态码严格对应；错误信息使用RFC标准描述
可读性强：测试场景描述使用业务语言（如“用户未登录时调用获取订单接口应返回401”），避免晦涩术语
覆盖全面：同时包含正向（Happy Path）、负向（异常）、破坏性（数据污染）三类场景


构图建议
测试用例的“视觉化组织结构”参考以下布局（适合文档或脚本注释）：

头部区：用例ID、优先级、关联需求编号（如 TC-001 | P1 | REQ-Order-002）
前置区：数据库预置数据、mock服务状态、前置接口调用链（以箭头或缩进表示层级）
请求区：完整URL、请求方法、headers（键值对排列）、body（JSON格式缩进）
预期区：状态码、响应体示例（用注释标注断言字段）、响应时间阈值
后置区：清理SQL语句、重置缓存指令、恢复mock状态


细节强化

边界值：对数字类型字段测试最小值-1、最小值、最大值+1；对字符串测试长度0、最大长度+1
空值/缺失：必填字段不传、传null、传空字符串；可选字段不传时验证默认值
数据格式：测试非预期数据类型（如字符串传入数字字段）、JSON转义、日期格式错误
鉴权与权限：无token、过期token、权限不足的token、伪造签名
幂等性：重复提交相同请求（如订单创建）应返回一致结果或幂等提示
并发与锁：模拟高并发下资源竞争，验证数据库唯一约束或乐观锁机制


使用建议

将核心提示词粘贴至AI对话（如ChatGPT、Claude）或代码生成工具中，替换{path}等占位符即可批量产出用例
结合pytest框架时，建议将提示词生成的用例直接转化为test_*.py文件，利用fixture管理前置/后置
团队内部可维护一份“测试用例风格指南”，将本提示词方案作为评审标准
对于已有Postman Collection的团队，可将提示词中的结构化字段映射到Postman的预请求脚本与测试脚本
持续迭代：每轮Sprint结束后，根据实际发现的漏测场景，补充新的提示词模板（如“分页参数边界测试模板”）