|
|
# 集成测试运行指南
|
|
|
|
|
|
## 运行测试
|
|
|
|
|
|
### 1. 运行所有测试
|
|
|
|
|
|
```bash
|
|
|
cd D:\Projects\nnet
|
|
|
go test ./test/integration -v
|
|
|
```
|
|
|
|
|
|
### 2. 运行特定测试
|
|
|
|
|
|
```bash
|
|
|
# 运行基础测试
|
|
|
go test ./test/integration -v -run TestBasicServerClient
|
|
|
|
|
|
# 运行路由测试
|
|
|
go test ./test/integration -v -run TestRouter
|
|
|
|
|
|
# 运行协议测试
|
|
|
go test ./test/integration -v -run TestProtocol
|
|
|
|
|
|
# 运行拦截器测试
|
|
|
go test ./test/integration -v -run TestInterceptor
|
|
|
|
|
|
# 运行编解码器测试
|
|
|
go test ./test/integration -v -run TestCodec
|
|
|
```
|
|
|
|
|
|
### 3. 运行测试并显示覆盖率
|
|
|
|
|
|
```bash
|
|
|
go test ./test/integration -v -cover
|
|
|
```
|
|
|
|
|
|
### 4. 运行测试并生成覆盖率报告
|
|
|
|
|
|
```bash
|
|
|
go test ./test/integration -v -coverprofile=coverage.out
|
|
|
go tool cover -html=coverage.out -o coverage.html
|
|
|
```
|
|
|
|
|
|
### 5. 运行测试并设置超时
|
|
|
|
|
|
```bash
|
|
|
go test ./test/integration -v -timeout 60s
|
|
|
```
|
|
|
|
|
|
## 获取测试结果
|
|
|
|
|
|
### 1. 控制台输出
|
|
|
|
|
|
测试结果会直接输出到控制台，包括：
|
|
|
- 测试名称
|
|
|
- 测试状态（PASS/FAIL）
|
|
|
- 测试日志（t.Logf输出）
|
|
|
- 错误信息（如果有）
|
|
|
|
|
|
### 2. 保存测试结果到文件
|
|
|
|
|
|
```bash
|
|
|
# 保存到文件
|
|
|
go test ./test/integration -v > test_results.txt 2>&1
|
|
|
|
|
|
# 或者使用PowerShell
|
|
|
go test ./test/integration -v 2>&1 | Tee-Object -FilePath test_results.txt
|
|
|
```
|
|
|
|
|
|
### 3. 使用JSON格式输出
|
|
|
|
|
|
```bash
|
|
|
go test ./test/integration -v -json > test_results.json
|
|
|
```
|
|
|
|
|
|
## 如何将测试结果告知我
|
|
|
|
|
|
### 方式1: 复制测试输出
|
|
|
|
|
|
1. 运行测试命令
|
|
|
2. 复制控制台输出
|
|
|
3. 将输出粘贴给我
|
|
|
|
|
|
### 方式2: 保存到文件并分享
|
|
|
|
|
|
1. 运行测试并保存到文件：
|
|
|
```bash
|
|
|
go test ./test/integration -v > test_results.txt 2>&1
|
|
|
```
|
|
|
2. 将 `test_results.txt` 文件内容分享给我
|
|
|
|
|
|
### 方式3: 只分享失败信息
|
|
|
|
|
|
如果测试失败，可以只分享失败的部分：
|
|
|
```bash
|
|
|
go test ./test/integration -v 2>&1 | Select-String -Pattern "FAIL|Error|timeout" -Context 5
|
|
|
```
|
|
|
|
|
|
## 测试结果格式说明
|
|
|
|
|
|
### 成功的测试
|
|
|
|
|
|
```
|
|
|
=== RUN TestBasicServerClient
|
|
|
--- PASS: TestBasicServerClient (1.23s)
|
|
|
```
|
|
|
|
|
|
### 失败的测试
|
|
|
|
|
|
```
|
|
|
=== RUN TestBasicServerClient
|
|
|
integration_test.go:75: Response for 'hello': ""
|
|
|
integration_test.go:77:
|
|
|
Error Trace: D:/Projects/nnet/test/integration/basic_test.go:77
|
|
|
Error: Received unexpected error:
|
|
|
read tcp 127.0.0.1:61899->127.0.0.1:61895: i/o timeout
|
|
|
Test: TestBasicServerClient
|
|
|
Messages: Request should succeed
|
|
|
--- FAIL: TestBasicServerClient (15.45s)
|
|
|
```
|
|
|
|
|
|
## 注意事项
|
|
|
|
|
|
1. **Windows防火墙**: 第一次运行时，Windows防火墙可能会弹出确认对话框，需要点击"允许访问"
|
|
|
|
|
|
2. **端口占用**: 测试使用随机端口，通常不会出现端口冲突。如果出现端口占用错误，可以：
|
|
|
- 等待几秒钟后重试
|
|
|
- 检查是否有其他进程占用端口
|
|
|
|
|
|
3. **超时设置**: 测试默认超时时间为3秒。如果测试经常超时，可以：
|
|
|
- 增加超时时间：`-timeout 60s`
|
|
|
- 检查服务器启动时间
|
|
|
- 查看KNOWN_ISSUES.md了解已知问题
|
|
|
|
|
|
4. **日志级别**: 测试使用info级别日志。如果需要更详细的日志，可以：
|
|
|
- 修改测试代码中的日志级别为debug
|
|
|
- 查看服务器日志输出
|
|
|
|
|
|
## 常见问题
|
|
|
|
|
|
### 1. 测试超时
|
|
|
|
|
|
**现象**: 测试超时，客户端无法收到响应
|
|
|
|
|
|
**可能原因**:
|
|
|
- 服务器启动慢
|
|
|
- 网络延迟
|
|
|
- gnet AsyncWrite机制问题（参见KNOWN_ISSUES.md）
|
|
|
|
|
|
**解决方法**:
|
|
|
- 增加超时时间
|
|
|
- 检查服务器日志
|
|
|
- 查看KNOWN_ISSUES.md
|
|
|
|
|
|
### 2. 端口冲突
|
|
|
|
|
|
**现象**: 错误信息显示端口已被占用
|
|
|
|
|
|
**解决方法**:
|
|
|
- 等待几秒钟后重试
|
|
|
- 检查是否有其他进程占用端口
|
|
|
- 测试使用随机端口，通常不会冲突
|
|
|
|
|
|
### 3. 防火墙阻止
|
|
|
|
|
|
**现象**: Windows防火墙弹出确认对话框
|
|
|
|
|
|
**解决方法**:
|
|
|
- 点击"允许访问"
|
|
|
- 在防火墙设置中添加例外（参见KNOWN_ISSUES.md）
|
|
|
|
|
|
## 测试文件说明
|
|
|
|
|
|
- `basic_test.go` - 基础测试（服务器-客户端通信、Echo路由、多客户端）
|
|
|
- `router_test.go` - 路由测试（帧数据路由、路由中间件）
|
|
|
- `protocol_test.go` - 协议测试（协议版本管理）
|
|
|
- `interceptor_test.go` - 拦截器测试（拦截器验证）
|
|
|
- `codec_test.go` - 编解码器测试（JSON、二进制编解码器）
|
|
|
- `simple_test.go` - 简单测试（用于调试）
|
|
|
- `integration_test.go` - 测试工具函数
|
|
|
- `helper.go` - 测试辅助函数
|
|
|
|
|
|
## 下一步
|
|
|
|
|
|
运行测试后，请将测试结果（特别是失败信息）分享给我，我会根据结果进行相应的修复和改进。
|
|
|
|