1.3 七牛如何做HTTP服务测试

• 语言: 中文（简体）
• 格式: .pdf
• 来源: github.com/gopherchina

摘要

文档详细介绍了七牛在HTTP服务测试中的实践方法。早期采用基于客户端SDK的测试方式，但面临耦合度过高和测试案例维护困难的问题。为了解决这些问题，七牛引入了httptest DSL，通过更直观的测试用例设计，减少了服务端与客户端SDK的耦合，专注于服务逻辑的测试。文档还展示了如何使用qiniutest工具编写HTTP测试案例，并提供了测试环境切换的实际操作示例。

AI总结

《七牛如何做HTTP服务测试》总结：

1. **HTTP服务测试类型**
- 单元测试：针对独立子服务的测试
- 集成测试：针对整个集群对外业务API的测试
- 测试环境：Stage环境（开发测试）、Product环境（生产测试）

2. **七牛早期测试方法**
- 基于客户端SDK编写测试用例
- 问题：
- 客户端SDK修改会导致测试用例编译失败
- 客户端SDK通常更关注用户体验，而非测试友好性
- 导致服务端与客户端SDK耦合，分散对服务逻辑测试的注意力

3. **直接基于协议测试的尝试**
- 使用`http.Client`直接编写测试用例
- 问题：
- 代码冗长
- 业务逻辑表达不够直观
- 为了解决问题，逐步编写测试专用SDK

4. **七牛当前测试方法**
- 引入`httptest` DSL（领域特定语言）
- 特点：
- 更接近基于`http.Client`的测试思路
- 努力让代码更直观地体现测试意图

5. **测试用例示例**

   #!/usr/bin/env qiniutest
   get http://www.qiniu.com/
   ret 200
   echo $(resp.body)

- 功能：下载www.qiniu.com首页，检查返回状态码是否为200
- 如果失败，测试终止；如果成功，打印返回内容（主要用于调试）

6. **命令行测试文法**
- 支持以下命令：
- `req`：定义HTTP请求方法和URL
- `header`：设置请求头
- `auth`：处理授权信息
- `body`：设置请求体
- `ret`：检查预期状态码
- `json`：处理JSON格式数据
- 示例：

     get http://foo.com/objects/$($id1)
     auth qiniutest `qiniu  `
     ret 200
     json '{\"a\":\"value1\", \"b\":1}'

7. **执行测试**
- Stage环境：

     QiniuTestEnv=stage qiniutest ./testfoo.qtf

- Product环境：

     QiniuTestEnv=product qiniutest ./testfoo.qtf

8. **未覆盖内容**
- `echo/println`：用于打印变量内容（调试）
- `auth`：授权的详细解剖
- `base64`：字符串的Base64编码/解码
- `case/setUp/tearDown`：如何定义多个测试案例
- 其他高级功能