100 lines
2.2 KiB
Markdown
100 lines
2.2 KiB
Markdown
# 快速开始 - 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：登录失败
|
||
```
|
||
❌ 登录失败
|
||
```
|
||
**解决方案**：检查用户名和密码是否正确。
|
||
|
||
### 错误3：Token过期
|
||
```
|
||
❌ 业务状态码: 401
|
||
```
|
||
**解决方案**：重新运行测试获取新Token。
|
||
|
||
## 🎯 下一步
|
||
|
||
- 查看 `README.md` 了解更多测试方式
|
||
- 使用 Apifox/Postman 导入 `api-test-collection.json` 进行可视化测试
|
||
- 配置 CI/CD 自动化测试
|
||
|
||
## 💡 提示
|
||
|
||
- 建议使用测试环境的API地址，不要直接测试生产环境
|
||
- 测试会自动清理创建的测试数据
|
||
- 可以将测试脚本加入 Git 版本控制
|
||
|
||
## 📞 需要帮助？
|
||
|
||
- 查看详细文档：`test/README.md`
|
||
- 查看API文档：`API对接方案.md`
|
||
- 提交Issue获取支持
|