1056 lines
23 KiB
Markdown
1056 lines
23 KiB
Markdown
# Top-Fans Backend HTTP 完整测试流程
|
||
|
||
本文档提供所有已实现接口的完整 HTTP 测试流程，按照真实使用场景组织。
|
||
|
||
---
|
||
|
||
## 📋 目录
|
||
|
||
- [前置准备](#前置准备)
|
||
- [测试场景1：新用户注册与认证](#测试场景1新用户注册与认证)
|
||
- [测试场景2：用户登录与个人信息管理](#测试场景2用户登录与个人信息管理)
|
||
- [测试场景3：粉丝身份管理](#测试场景3粉丝身份管理)
|
||
- [测试场景4：账户安全](#测试场景4账户安全)
|
||
- [错误场景测试](#错误场景测试)
|
||
- [接口清单](#接口清单)
|
||
|
||
---
|
||
|
||
## 前置准备
|
||
|
||
### 1. 启动服务
|
||
|
||
```bash
|
||
# 终端 1: 启动 userService
|
||
cd /Users/haihuizhu/infinite_matrix/top-fans/backend/services/userService
|
||
go run main.go
|
||
|
||
# 终端 2: 启动 Gateway
|
||
cd /Users/haihuizhu/infinite_matrix/top-fans/backend/gateway
|
||
go run main.go
|
||
```
|
||
|
||
### 2. 验证服务运行
|
||
|
||
```bash
|
||
# 检查 Dubbo 服务（端口 20000）
|
||
lsof -i :20000
|
||
|
||
# 检查 Gateway（端口 8080）
|
||
lsof -i :8080
|
||
|
||
# 测试 Gateway 健康检查
|
||
curl http://localhost:8080/health
|
||
```
|
||
|
||
### 3. 准备测试数据
|
||
|
||
确保数据库中有以下 stars 数据：
|
||
|
||
```sql
|
||
-- 肖战（identity_id: xz）
|
||
INSERT INTO stars (star_id, name, tag, name_en, pic_url, description, identity_id, is_active, created_at, updated_at)
|
||
VALUES (87, '肖战', '小飞侠', 'xiaozhan', '', '', 'xz', true, 1767590443835, 1767590443835);
|
||
|
||
-- 王一博（identity_id: wyb）
|
||
INSERT INTO stars (star_id, name, tag, name_en, pic_url, description, identity_id, is_active, created_at, updated_at)
|
||
VALUES (88, '王一博', '小摩托', 'wangyibo', '', '', 'wyb', true, 1767590443835, 1767590443835);
|
||
```
|
||
|
||
### 4. 环境变量
|
||
|
||
```bash
|
||
export BASE_URL="http://localhost:8080"
|
||
export API_VERSION="v1"
|
||
```
|
||
|
||
---
|
||
|
||
## 测试场景1：新用户注册与认证
|
||
|
||
### 1.1 查看可选粉丝身份列表
|
||
|
||
**目的**：用户注册前，先查看有哪些明星可以选择。
|
||
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/fan-identities" | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"items": [
|
||
{
|
||
"star_id": 87,
|
||
"identity_id": "xz",
|
||
"name": "肖战",
|
||
"tag": "小飞侠",
|
||
"pic_url": ""
|
||
},
|
||
{
|
||
"star_id": 88,
|
||
"identity_id": "wyb",
|
||
"name": "王一博",
|
||
"tag": "小摩托",
|
||
"pic_url": ""
|
||
}
|
||
],
|
||
"total": 2
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 1.2 用户注册
|
||
|
||
**目的**：新用户注册并选择初始粉丝身份。
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/register" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13900000001",
|
||
"password": "password123",
|
||
"star_id": 87,
|
||
"nickname": "不爱战战"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"access_token": "eyJhbGci...",
|
||
"expires_in": 604800,
|
||
"user": {
|
||
"uid": 1,
|
||
"nickname": "爱战战",
|
||
"avatar_url": "",
|
||
"chain_address": "",
|
||
"fan_identity": {
|
||
"identity_id": "xz",
|
||
"name": "肖战",
|
||
"tag": "小飞侠"
|
||
},
|
||
"fan_level": 1,
|
||
"starbook_limit": 1,
|
||
"slot_limit": 1,
|
||
"assets_count": 0,
|
||
"crystal_balance": 0
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
**重要**：保存返回的 `access_token`，后续请求需要用到。
|
||
|
||
```bash
|
||
# 保存 Token 到环境变量（替换为实际返回的 token）
|
||
export TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoxMDYsInN0YXJfaWQiOjg3LCJ1cGRhdGVkX2F0IjoxNzY3Njg5NzI0NTU1LCJleHAiOjE3NjgyOTQ1MjQsImlhdCI6MTc2NzY4OTcyNH0.emLob9wybZgqU7O5j-mOzBJQTm-Bvz-iaBu8Nb3wr_Q"
|
||
```
|
||
|
||
---
|
||
|
||
### 1.3 获取当前用户信息
|
||
|
||
**目的**：验证注册成功，获取完整用户信息。
|
||
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"uid": 1,
|
||
"nickname": "爱战战",
|
||
"avatar_url": "",
|
||
"chain_address": "",
|
||
"current_identity": {
|
||
"identity_id": "xz",
|
||
"identity_name": "肖战",
|
||
"tag": "小飞侠",
|
||
"level": 1,
|
||
"crystal_balance": 0
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 测试场景2：用户登录与个人信息管理
|
||
|
||
### 2.1 用户登录
|
||
|
||
**目的**：已注册用户使用手机号和密码登录。
|
||
|
||
**基本登录（使用默认身份）**：
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/login" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13900000001",
|
||
"password": "password123"
|
||
}' | jq .
|
||
```
|
||
|
||
**指定明星身份登录**：
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/login" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13900000001",
|
||
"password": "password123",
|
||
"star_id": 87
|
||
}' | jq .
|
||
```
|
||
|
||
**请求参数说明**：
|
||
- `mobile` (必填): 手机号
|
||
- `password` (必填): 密码
|
||
- `star_id` (可选): 指定登录的明星ID
|
||
- **不指定**：使用最早创建的粉丝档案（默认行为）
|
||
- **指定**：切换到指定明星的粉丝身份，前提是用户已创建该明星的粉丝档案
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"access_token": "eyJhbGci...",
|
||
"expires_in": 604800,
|
||
"user": {
|
||
"uid": 1,
|
||
"nickname": "爱战战",
|
||
"avatar_url": "",
|
||
"chain_address": "",
|
||
"fan_identity": {
|
||
"identity_id": "xz",
|
||
"name": "肖战",
|
||
"tag": "小飞侠"
|
||
},
|
||
"fan_level": 1,
|
||
"starbook_limit": 1,
|
||
"slot_limit": 1,
|
||
"assets_count": 0,
|
||
"crystal_balance": 0
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
**更新 Token**：
|
||
```bash
|
||
export TOKEN="<新的 access_token>"
|
||
```
|
||
|
||
---
|
||
|
||
### 2.2 获取个人信息
|
||
|
||
**目的**：查看当前粉丝身份下的详细个人信息。
|
||
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/me/profile" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"uid": 1,
|
||
"nickname": "爱战战",
|
||
"chain_address": "",
|
||
"fan_identity": {
|
||
"identity_id": "xz",
|
||
"name": "肖战",
|
||
"tag": "小飞侠"
|
||
},
|
||
"fan_level": 1,
|
||
"starbook_limit": 1,
|
||
"slot_limit": 1,
|
||
"assets_count": 0,
|
||
"crystal_balance": 0
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 2.3 修改昵称
|
||
|
||
**目的**：用户修改自己的昵称。
|
||
|
||
```bash
|
||
curl -X PUT "${BASE_URL}/api/${API_VERSION}/me/nickname" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"nickname": "爱战战的小飞侠"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"nickname": "爱战战的小飞侠"
|
||
}
|
||
}
|
||
```
|
||
|
||
**验证修改**：
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/me/profile" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .data.nickname
|
||
```
|
||
|
||
预期输出：`"爱战战的小飞侠"`
|
||
|
||
---
|
||
|
||
## 测试场景3：粉丝身份管理
|
||
|
||
### 3.1 添加第二个粉丝身份
|
||
|
||
**目的**：用户添加第二个粉丝身份（最多2个）。
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/my/fan-identities" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"star_id": 88,
|
||
"nickname": "爱一博"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"bound": true,
|
||
"identity_id": "wyb"
|
||
}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 3.2 查询我的粉丝身份列表
|
||
|
||
**目的**：查询当前用户拥有的所有粉丝身份。
|
||
|
||
**注意**：请确保URL中没有多余的斜杠，正确的路径是 `/api/v1/my/fan-identities`（不是 `/api/v1//my/fan-identities`）
|
||
|
||
```bash
|
||
# 方式一：使用变量（推荐）
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/my/fan-identities" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
|
||
# 方式二：直接使用完整URL
|
||
curl -X GET "http://localhost:8080/api/v1/my/fan-identities" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"items": [
|
||
{
|
||
"star_id": 87,
|
||
"identity_id": "xz",
|
||
"star_name": "肖战",
|
||
"star_tag": "小飞侠",
|
||
"nickname": "小飞侠战战",
|
||
"level": 1,
|
||
"experience": 0,
|
||
"crystal_balance": 0,
|
||
"is_active": true
|
||
},
|
||
{
|
||
"star_id": 88,
|
||
"identity_id": "wyb",
|
||
"star_name": "王一博",
|
||
"star_tag": "小摩托",
|
||
"nickname": "爱一博",
|
||
"level": 1,
|
||
"experience": 0,
|
||
"crystal_balance": 0,
|
||
"is_active": false
|
||
}
|
||
],
|
||
"total": 2,
|
||
"current_star_id": 87
|
||
}
|
||
}
|
||
```
|
||
|
||
**验证要点**：
|
||
- ✅ 返回用户拥有的所有粉丝身份
|
||
- ✅ `identity_id`、`star_name`、`star_tag` 正确显示明星信息（如 "xz"、"肖战"、"小飞侠"）
|
||
- ✅ `is_active` 为 `true` 表示当前激活的身份（与 `current_star_id` 对应）
|
||
- ✅ `current_star_id` 显示当前激活的明星ID（从 Token 中获取）
|
||
- ✅ 每个身份包含昵称、等级、经验值、水晶余额等完整信息
|
||
- ✅ 如果用户有2个粉丝身份，应该返回2条记录
|
||
|
||
---
|
||
|
||
### 3.4 查看可选身份列表（搜索功能）
|
||
|
||
**目的**：测试身份列表的搜索功能。
|
||
|
||
```bash
|
||
# 搜索"王一博"
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/fan-identities?keyword=王一博" | jq .
|
||
|
||
# 搜索"肖战"
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/fan-identities?keyword=肖战" | jq .
|
||
|
||
# 分页查询
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/fan-identities?page=1&page_size=10" | jq .
|
||
```
|
||
|
||
---
|
||
|
||
### 3.5 切换粉丝身份
|
||
|
||
**目的**：切换到另一个粉丝身份，系统会返回新的 Token。
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/my/fan-identities/switch" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"new_star_id": 88
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {
|
||
"access_token": "eyJhbGci...",
|
||
"expires_in": 604800,
|
||
"current_identity": {
|
||
"identity_id": "wyb",
|
||
"identity_name": "王一博",
|
||
"tag": "小摩托",
|
||
"level": 1,
|
||
"crystal_balance": 0
|
||
}
|
||
}
|
||
}
|
||
```
|
||
|
||
**重要**：切换身份后会返回新的 Token，必须更新。
|
||
|
||
```bash
|
||
export TOKEN="<新的 access_token>"
|
||
```
|
||
|
||
**验证切换结果**：
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .data.current_identity
|
||
```
|
||
|
||
预期输出：
|
||
```json
|
||
{
|
||
"identity_id": "wyb",
|
||
"identity_name": "王一博",
|
||
"tag": "小摩托",
|
||
"level": 1,
|
||
"crystal_balance": 0
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 3.4 再次切换回第一个身份
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/my/fan-identities/switch" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"new_star_id": 87
|
||
}' | jq .
|
||
```
|
||
|
||
更新 Token 并验证。
|
||
|
||
---
|
||
|
||
## 测试场景4：账户安全
|
||
|
||
### 4.1 修改密码
|
||
|
||
**目的**：用户修改登录密码，修改后当前 Token 会失效。
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/account/password" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"old_password": "password123",
|
||
"new_password": "newPassword456"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {}
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 4.2 验证旧 Token 失效
|
||
|
||
**目的**：确认修改密码后，旧 Token 立即失效。
|
||
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 401,
|
||
"message": "token已失效或不存在"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 4.3 使用新密码重新登录
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/login" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13800000001",
|
||
"password": "newPassword456"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期**：登录成功，获取新 Token。
|
||
|
||
```bash
|
||
export TOKEN="<新的 access_token>"
|
||
```
|
||
|
||
---
|
||
|
||
### 4.4 退出登录
|
||
|
||
**目的**：用户主动退出登录，Token 会被清除。
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/logout" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 200,
|
||
"message": "ok",
|
||
"data": {}
|
||
}
|
||
```
|
||
|
||
**验证退出成功**：
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
```
|
||
|
||
**预期响应**：401 未授权。
|
||
|
||
---
|
||
|
||
## 错误场景测试
|
||
|
||
### 5.1 重复注册（手机号已存在）
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/register" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13800000001",
|
||
"password": "password123",
|
||
"star_id": 87,
|
||
"nickname": "重复用户"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 400,
|
||
"message": "手机号已存在"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 5.2 登录密码错误
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/login" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13800000001",
|
||
"password": "wrongPassword"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 401,
|
||
"message": "密码错误"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 5.3 使用无效 Token 访问受保护接口
|
||
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" \
|
||
-H "Authorization: Bearer invalid_token" | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 401,
|
||
"message": "invalid token"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 5.4 缺少 Authorization Header
|
||
|
||
```bash
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 401,
|
||
"message": "missing authorization token"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 5.5 添加第三个粉丝身份（超过限制）
|
||
|
||
```bash
|
||
# 先注册一个新用户
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/register" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13800000002",
|
||
"password": "password123",
|
||
"star_id": 87,
|
||
"nickname": "测试用户2"
|
||
}' | jq .
|
||
|
||
# 保存新 Token
|
||
export TOKEN2="<新用户的 token>"
|
||
|
||
# 添加第二个身份
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/my/fan-identities" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN2}" \
|
||
-d '{
|
||
"star_id": 88,
|
||
"nickname": "第二个身份"
|
||
}' | jq .
|
||
|
||
# 尝试添加第三个身份（应该失败）
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/my/fan-identities" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN2}" \
|
||
-d '{
|
||
"star_id": 89,
|
||
"nickname": "第三个身份"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 400,
|
||
"message": "最多只能拥有2个粉丝身份"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 5.6 修改密码时旧密码错误
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/account/password" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"old_password": "wrongOldPassword",
|
||
"new_password": "newPassword456"
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 400,
|
||
"message": "旧密码错误"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
### 5.7 切换到不存在的身份
|
||
|
||
```bash
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/my/fan-identities/switch" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"new_star_id": 999
|
||
}' | jq .
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"code": 404,
|
||
"message": "粉丝档案不存在"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## 接口清单
|
||
|
||
### ✅ 已实现的接口（共10个）
|
||
|
||
#### 认证相关（5个）
|
||
| 方法 | 路径 | 说明 | 需要认证 |
|
||
|------|------|------|---------|
|
||
| POST | `/api/v1/auth/register` | 用户注册 | ❌ |
|
||
| POST | `/api/v1/auth/login` | 用户登录 | ❌ |
|
||
| GET | `/api/v1/auth/me` | 获取当前用户 | ✅ |
|
||
| POST | `/api/v1/auth/logout` | 退出登录 | ✅ |
|
||
| POST | `/api/v1/account/password` | 修改密码 | ✅ |
|
||
|
||
#### 粉丝身份相关（3个）
|
||
| 方法 | 路径 | 说明 | 需要认证 |
|
||
|------|------|------|---------|
|
||
| GET | `/api/v1/fan-identities` | 获取粉丝身份列表 | ❌ |
|
||
| POST | `/api/v1/my/fan-identities` | 添加粉丝身份 | ✅ |
|
||
| POST | `/api/v1/my/fan-identities/switch` | 切换粉丝身份 | ✅ |
|
||
|
||
#### 个人信息相关（2个）
|
||
| 方法 | 路径 | 说明 | 需要认证 |
|
||
|------|------|------|---------|
|
||
| GET | `/api/v1/me/profile` | 获取个人信息 | ✅ |
|
||
| PUT | `/api/v1/me/nickname` | 修改昵称 | ✅ |
|
||
|
||
---
|
||
|
||
## 完整测试脚本
|
||
|
||
将以下脚本保存为 `test_all.sh`，一键运行所有测试：
|
||
|
||
```bash
|
||
#!/bin/bash
|
||
|
||
# 颜色输出
|
||
RED='\033[0;31m'
|
||
GREEN='\033[0;32m'
|
||
YELLOW='\033[1;33m'
|
||
NC='\033[0m' # No Color
|
||
|
||
# 配置
|
||
BASE_URL="http://localhost:8080"
|
||
API_VERSION="v1"
|
||
|
||
echo -e "${GREEN}========================================${NC}"
|
||
echo -e "${GREEN} Top-Fans Backend 完整测试流程${NC}"
|
||
echo -e "${GREEN}========================================${NC}\n"
|
||
|
||
# 1. 查看粉丝身份列表
|
||
echo -e "${YELLOW}[测试 1/10] 查看粉丝身份列表${NC}"
|
||
curl -s -X GET "${BASE_URL}/api/${API_VERSION}/fan-identities" | jq .
|
||
echo -e "\n"
|
||
|
||
# 2. 注册新用户
|
||
echo -e "${YELLOW}[测试 2/10] 注册新用户${NC}"
|
||
REGISTER_RESPONSE=$(curl -s -X POST "${BASE_URL}/api/${API_VERSION}/auth/register" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13900000001",
|
||
"password": "password123",
|
||
"star_id": 87,
|
||
"nickname": "测试用户"
|
||
}')
|
||
echo "$REGISTER_RESPONSE" | jq .
|
||
TOKEN=$(echo "$REGISTER_RESPONSE" | jq -r '.data.access_token')
|
||
echo -e "${GREEN}Token: ${TOKEN}${NC}\n"
|
||
|
||
# 3. 获取当前用户
|
||
echo -e "${YELLOW}[测试 3/10] 获取当前用户${NC}"
|
||
curl -s -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
echo -e "\n"
|
||
|
||
# 4. 获取个人信息
|
||
echo -e "${YELLOW}[测试 4/10] 获取个人信息${NC}"
|
||
curl -s -X GET "${BASE_URL}/api/${API_VERSION}/me/profile" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
echo -e "\n"
|
||
|
||
# 5. 修改昵称
|
||
echo -e "${YELLOW}[测试 5/10] 修改昵称${NC}"
|
||
curl -s -X PUT "${BASE_URL}/api/${API_VERSION}/me/nickname" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"nickname": "新昵称测试"
|
||
}' | jq .
|
||
echo -e "\n"
|
||
|
||
# 6. 添加第二个粉丝身份
|
||
echo -e "${YELLOW}[测试 6/10] 添加第二个粉丝身份${NC}"
|
||
curl -s -X POST "${BASE_URL}/api/${API_VERSION}/my/fan-identities" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"star_id": 88,
|
||
"nickname": "第二个身份"
|
||
}' | jq .
|
||
echo -e "\n"
|
||
|
||
# 7. 切换粉丝身份
|
||
echo -e "${YELLOW}[测试 7/10] 切换粉丝身份${NC}"
|
||
SWITCH_RESPONSE=$(curl -s -X POST "${BASE_URL}/api/${API_VERSION}/my/fan-identities/switch" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"new_star_id": 88
|
||
}')
|
||
echo "$SWITCH_RESPONSE" | jq .
|
||
TOKEN=$(echo "$SWITCH_RESPONSE" | jq -r '.data.access_token')
|
||
echo -e "${GREEN}新 Token: ${TOKEN}${NC}\n"
|
||
|
||
# 8. 验证切换结果
|
||
echo -e "${YELLOW}[测试 8/10] 验证切换结果${NC}"
|
||
curl -s -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .data.current_identity
|
||
echo -e "\n"
|
||
|
||
# 9. 修改密码
|
||
echo -e "${YELLOW}[测试 9/10] 修改密码${NC}"
|
||
curl -s -X POST "${BASE_URL}/api/${API_VERSION}/account/password" \
|
||
-H "Content-Type: application/json" \
|
||
-H "Authorization: Bearer ${TOKEN}" \
|
||
-d '{
|
||
"old_password": "password123",
|
||
"new_password": "newPassword456"
|
||
}' | jq .
|
||
echo -e "\n"
|
||
|
||
# 10. 使用新密码登录
|
||
echo -e "${YELLOW}[测试 10/10] 使用新密码登录${NC}"
|
||
LOGIN_RESPONSE=$(curl -s -X POST "${BASE_URL}/api/${API_VERSION}/auth/login" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"mobile": "13900000001",
|
||
"password": "newPassword456"
|
||
}')
|
||
echo "$LOGIN_RESPONSE" | jq .
|
||
TOKEN=$(echo "$LOGIN_RESPONSE" | jq -r '.data.access_token')
|
||
echo -e "\n"
|
||
|
||
# 11. 退出登录
|
||
echo -e "${YELLOW}[额外测试] 退出登录${NC}"
|
||
curl -s -X POST "${BASE_URL}/api/${API_VERSION}/auth/logout" \
|
||
-H "Authorization: Bearer ${TOKEN}" | jq .
|
||
echo -e "\n"
|
||
|
||
echo -e "${GREEN}========================================${NC}"
|
||
echo -e "${GREEN} 测试完成！${NC}"
|
||
echo -e "${GREEN}========================================${NC}"
|
||
```
|
||
|
||
**运行脚本**：
|
||
|
||
```bash
|
||
chmod +x test_all.sh
|
||
./test_all.sh
|
||
```
|
||
|
||
---
|
||
|
||
## 性能测试（可选）
|
||
|
||
使用 `apache-bench` 进行简单的性能测试：
|
||
|
||
```bash
|
||
# 安装 apache-bench（如果未安装）
|
||
# macOS: brew install httpd
|
||
# Ubuntu: sudo apt-get install apache2-utils
|
||
|
||
# 测试登录接口（100个请求，10个并发）
|
||
ab -n 100 -c 10 -p login.json -T application/json \
|
||
http://localhost:8080/api/v1/auth/login
|
||
|
||
# login.json 内容：
|
||
# {"mobile":"13800000001","password":"password123"}
|
||
```
|
||
|
||
---
|
||
|
||
## 故障排查
|
||
|
||
### 问题1：401 Unauthorized
|
||
|
||
**可能原因**：
|
||
1. Token 过期
|
||
2. Token 格式错误（缺少 "Bearer " 前缀）
|
||
3. 修改密码或退出登录后 Token 失效
|
||
|
||
**解决方案**：
|
||
```bash
|
||
# 检查 Token 格式
|
||
echo "Authorization: Bearer ${TOKEN}"
|
||
|
||
# 重新登录获取新 Token
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/login" \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"mobile":"13800000001","password":"password123"}'
|
||
```
|
||
|
||
---
|
||
|
||
### 问题2：Connection Refused
|
||
|
||
**可能原因**：服务未启动
|
||
|
||
**解决方案**：
|
||
```bash
|
||
# 检查服务状态
|
||
lsof -i :20000 # Dubbo 服务
|
||
lsof -i :8080 # Gateway
|
||
|
||
# 重新启动服务
|
||
cd /Users/haihuizhu/infinite_matrix/top-fans/backend/services/userService
|
||
go run main.go
|
||
|
||
cd /Users/haihuizhu/infinite_matrix/top-fans/backend/gateway
|
||
go run main.go
|
||
```
|
||
|
||
---
|
||
|
||
### 问题3：数据库连接错误
|
||
|
||
**检查数据库连接**：
|
||
```bash
|
||
psql -h localhost -U haihuizhu -d top-fans -c "SELECT * FROM stars;"
|
||
```
|
||
|
||
---
|
||
|
||
## 附录
|
||
|
||
### A. 快速参考
|
||
|
||
```bash
|
||
# 设置环境变量
|
||
export BASE_URL="http://localhost:8080"
|
||
export API_VERSION="v1"
|
||
export TOKEN="your_token_here"
|
||
|
||
# 常用命令
|
||
# 注册
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/register" -H "Content-Type: application/json" -d '{"mobile":"13800000001","password":"password123","star_id":87,"nickname":"测试"}'
|
||
|
||
# 登录
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/login" -H "Content-Type: application/json" -d '{"mobile":"13800000001","password":"password123"}'
|
||
|
||
# 获取当前用户
|
||
curl -X GET "${BASE_URL}/api/${API_VERSION}/auth/me" -H "Authorization: Bearer ${TOKEN}"
|
||
|
||
# 退出登录
|
||
curl -X POST "${BASE_URL}/api/${API_VERSION}/auth/logout" -H "Authorization: Bearer ${TOKEN}"
|
||
```
|
||
|
||
---
|
||
|
||
### B. 响应码说明
|
||
|
||
| 状态码 | 说明 |
|
||
|--------|------|
|
||
| 200 | 成功 |
|
||
| 400 | 请求参数错误 |
|
||
| 401 | 未授权（Token 无效或过期）|
|
||
| 404 | 资源不存在 |
|
||
| 500 | 服务器内部错误 |
|
||
|
||
---
|
||
|
||
## 总结
|
||
|
||
✅ **已实现 10 个 HTTP 接口**，覆盖：
|
||
- 用户注册、登录、退出
|
||
- 个人信息查询与修改
|
||
- 粉丝身份管理（查看、添加、切换）
|
||
- 账户安全（修改密码）
|
||
|
||
📝 **测试要点**：
|
||
1. 所有受保护接口都需要 `Authorization: Bearer <token>` Header
|
||
2. 修改密码和退出登录会使当前 Token 失效
|
||
3. 切换粉丝身份会返回新的 Token
|
||
4. 每个用户最多有 2 个粉丝身份
|
||
|
||
🎉 **所有接口均已测试通过，可以进行前端对接！**
|
||
|