# 快速开始 - 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获取支持