2. 接口自动化框架应该包含哪些模块
接口自动化框架不是把几条接口脚本放在一起，也不是简单地用 requests 或 RestAssured 调接口。一个可维护的接口自动化框架，应该包含配置管理、请求封装、用例管理、数据驱动、断言封装、日志、报告、数据库校验、环境切换、持续集成等模块。面试中如果能把这些模块讲清楚，会比只说“我会写接口自动化”更有说服力。
框架设计的目标是：新增用例方便、公共逻辑复用、失败可定位、环境可切换、结果可追踪。测试自动化不是一次性脚本，而是长期维护的工程项目。
一、配置管理模块
配置管理用于维护不同环境和公共参数。
常见配置：
- base_url；
- 数据库连接；
- Redis 配置；
- MQ 配置；
- 默认账号；
- 超时时间；
- 报告路径；
- 日志级别。
配置可以放在 YAML、JSON、properties 或环境变量中。
核心要求：不要把环境地址、账号、Token 写死在代码里。
二、请求封装模块
请求封装是接口框架的核心。
封装内容：
- GET、POST、PUT、DELETE；
- URL 拼接；
- Header；
- params；
- JSON body；
- form-data；
- 文件上传；
- timeout；
- SSL 配置；
- 请求和响应日志；
- 异常处理。
所有用例统一走请求封装，可以降低重复代码。
三、鉴权模块
很多接口需要登录态。
鉴权模块负责：
- 登录获取 Token；
- Cookie 管理；
- Token 自动注入 Header；
- Token 过期重新登录；
- 多角色账号切换；
- 权限场景测试。
如果 Token 写死，自动化很容易失效。
四、测试数据模块
测试数据可以来自：
- YAML；
- JSON；
- Excel；
- CSV；
- 数据库；
- 代码生成。
测试数据模块要支持：
- 数据读取；
- 参数化；
- 动态变量替换；
- 前后接口数据关联；
- 测试数据清理。
数据和代码分离，是框架可维护的关键。
五、用例管理模块
用例通常按业务模块组织：
testcases/
test_login.py
test_order.py
test_payment.py
或者 Java 中：
LoginTest.java
OrderTest.java
PaymentTest.java
用例层应该尽量聚焦业务流程和断言，不要堆大量底层请求细节。
六、断言模块
断言模块用于统一校验结果。
常见断言：
- HTTP 状态码；
- 业务 code；
- message；
- data 字段；
- 字段类型；
- JSON Schema；
- 数据库记录；
- 响应时间；
- 异步结果。
好的断言要提供清晰失败信息：预期是什么、实际是什么、哪个接口失败。
七、日志模块
日志用于定位失败。
建议记录：
- 用例名称；
- 请求方法；
- URL；
- Header；
- 请求参数；
- 响应状态码；
- 响应体；
- 断言结果；
- 异常堆栈；
- TraceId。
注意敏感信息脱敏，比如密码、Token。
八、报告模块
常见报告：
- Allure；
- pytest-html；
- ExtentReport；
- TestNG Report。
报告要能展示：
- 总用例数；
- 通过失败数；
- 失败原因；
- 请求响应详情；
- 执行环境；
- 执行耗时；
- 附件和日志。
报告不是为了好看，而是为了定位问题。
九、数据库校验模块
接口返回成功不代表数据库正确。
数据库校验适合：
- 创建订单后查订单表；
- 支付后查订单状态；
- 删除后查软删除字段；
- 权限变更后查角色表；
- 数据同步后查结果表。
数据库工具模块要负责连接、查询、关闭资源和异常记录。
十、环境切换模块
自动化通常要支持测试环境、预发环境、回归环境。
环境切换方式：
- 命令行参数；
- 配置文件；
- Jenkins 参数；
- 环境变量。
不要为了切换环境修改代码。
十一、持续集成模块
持续集成通常用 Jenkins 或 GitLab CI。
流程：
- 拉取代码；
- 安装依赖；
- 选择环境；
- 执行自动化；
- 生成报告；
- 发送通知；
- 保存日志。
CI 让自动化从本地脚本变成团队能力。
十二、面试回答模板
如果面试官问“接口自动化框架应该包含哪些模块”，可以这样回答：
一个接口自动化框架至少包括配置管理、请求封装、鉴权、测试数据、用例管理、断言、日志、报告、数据库校验和持续集成。配置模块管理多环境 base_url、账号和数据库；请求模块统一封装 method、url、headers、params、body、timeout 和异常；鉴权模块负责登录获取 Token 并自动注入 Header；数据模块支持 YAML/JSON/Excel 参数化和接口关联；断言模块不仅校验状态码，还校验业务 code、关键字段和数据库结果；日志和报告用于失败定位；最后通过 Jenkins 定时执行并发送报告。
十三、常见追问
追问：最核心的模块是什么？
请求封装、数据驱动、断言和日志是最核心的。没有这些，框架就只是脚本集合。
追问：为什么要封装断言？
统一断言逻辑和失败信息，方便维护和定位。
追问：如何支持多环境？
用配置文件或命令行参数管理不同 base_url 和数据库连接，执行时选择环境。
十四、练习清单
- 设计框架目录；
- 封装请求方法；
- 配置多环境；
- 管理 Token；
- 读取测试数据；
- 实现接口关联；
- 封装断言；
- 加日志；
- 加报告；
- 接入 Jenkins。
接口自动化框架的价值是长期维护和团队复用。模块越清晰，后期新增用例和定位失败越容易。
配套刷题：
