This commit is contained in:
2025-12-12 01:44:41 +08:00
parent 21abcaff53
commit 2f1d732a36
46 changed files with 7756 additions and 484 deletions
+99
View File
@@ -0,0 +1,99 @@
# 快速开始 - 5分钟完成API测试
## 📦 第一步:安装依赖
```bash
cd test
npm install
```
## ⚙️ 第二步:配置测试参数
编辑 `quick-test.js``api-test.js`,修改以下内容:
```javascript
const config = {
baseURL: 'http://your-api-domain.com', // 改成实际的API地址
testUser: {
username: 'test_user', // 改成测试账号
password: 'test_password' // 改成测试密码
}
};
```
## 🚀 第三步:运行测试
### 方式1:快速测试(推荐新手)
只测试5个核心接口,30秒内完成:
```bash
npm run test:quick
```
### 方式2:完整测试
测试所有14个接口,包含数据清理:
```bash
npm run test
```
## 📊 查看测试结果
测试会自动输出结果:
```
🚀 武术比赛报名系统 - 快速测试
📍 API地址: http://your-api-domain.com
🔐 测试登录...
✅ 登录成功
📋 测试赛事列表...
✅ 赛事列表获取成功 (10条数据)
👥 测试选手列表...
✅ 选手列表获取成功 (25条数据)
👤 测试用户信息...
✅ 用户信息获取成功 (测试用户)
📝 测试报名列表...
✅ 报名列表获取成功 (3条数据)
==================================================
📊 测试结果: 5个通过, 0个失败
✨ 成功率: 100.0%
==================================================
```
## ❌ 常见错误处理
### 错误1:网络请求失败
```
❌ 请求失败: connect ECONNREFUSED
```
**解决方案**:检查 baseURL 是否正确,服务器是否启动。
### 错误2:登录失败
```
❌ 登录失败
```
**解决方案**:检查用户名和密码是否正确。
### 错误3Token过期
```
❌ 业务状态码: 401
```
**解决方案**:重新运行测试获取新Token。
## 🎯 下一步
- 查看 `README.md` 了解更多测试方式
- 使用 Apifox/Postman 导入 `api-test-collection.json` 进行可视化测试
- 配置 CI/CD 自动化测试
## 💡 提示
- 建议使用测试环境的API地址,不要直接测试生产环境
- 测试会自动清理创建的测试数据
- 可以将测试脚本加入 Git 版本控制
## 📞 需要帮助?
- 查看详细文档:`test/README.md`
- 查看API文档:`API对接方案.md`
- 提交Issue获取支持