api-testing-patterns

api-testing-patterns 技能为分布式系统与微服务提供了一套标准化的质量工程框架。它专为软件工程师、QA 自动化专家及 DevOps 团队设计，旨在确保服务间稳健的通信，并减少对脆弱的“实现相关型测试”的依赖。通过将 API 视为明确的合约，本技能协助团队识别合约测试、组件测试及集成测试，以实现速度与可靠性的平衡。

• 消费者驱动的合约测试：实现 Pact 或 Spring Cloud Contract 模式，确保服务提供者满足消费者需求，从而尽早防止开发生命周期中的破坏性变更。

• REST 与 GraphQL 生命周期测试：执行针对 CRUD 操作、分页、过滤、模式验证及 GraphQL 复杂度限制的结构化测试。

• 进阶场景验证：涵盖身份验证（401/403）、输入验证（400）、优雅错误处理（500）、幂等性键值管理及并发竞态条件的测试场景。

• 性能与集成：提供使用 k6、Artillery 或 JMeter 对关键端点进行负载测试的工具，以及针对真实依赖的集成测试策略。

• CI/CD 与质量门槛：将模式验证与合约检查直接嵌入 CI 流水线的实践，实现自动化与持续性的质量保证。

• 当您需要构建新的 API 测试策略或重构现有测试以摆脱对实现的依赖时，请使用此技能。

• 常见输入包含 API 规格书（OpenAPI/Swagger）、端点文档或服务合约；输出包含经验证的测试套件、覆盖率报告及合约偏移（drift）分析。

• 测试时应优先从消费者的视角出发，避免对额外字段或不稳定的响应数据进行断言，以维护测试稳定性。

• 可与 qe-api-contract-validator 代理集成以检测自动偏移，并透过 qe-test-generator 根据既有定义快速建立测试套件。

• 针对微服务，优先考虑使用 Mock 进行组件级隔离，仅针对需要真实环境模拟的复杂关键依赖进行集成测试。