martial-mini/test/QUICKSTART.md

快速开始 - 5分钟完成API测试

📦 第一步：安装依赖

cd test
npm install

⚙️ 第二步：配置测试参数

编辑 quick-test.js 或 api-test.js，修改以下内容：

const config = {
  baseURL: 'http://your-api-domain.com',  // 改成实际的API地址
  testUser: {
    username: 'test_user',      // 改成测试账号
    password: 'test_password'   // 改成测试密码
  }
};

🚀 第三步：运行测试

方式1：快速测试（推荐新手）

只测试5个核心接口，30秒内完成：

npm run test:quick

方式2：完整测试

测试所有14个接口，包含数据清理：

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获取支持