xiaoyu/topfans
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
8ec1942e74
topfans/backend/docs/资产服务和点赞服务HTTP完整测试流程.md
zerosaturation 06f4038a75 提交后端代码
2026-04-07 22:29:48 +08:00

26 KiB
Raw Blame History

资产服务和点赞服务 HTTP 完整测试流程

目录

  1. 环境准备
  2. 服务启动
  3. 用户准备
  4. 资产功能测试
  5. 点赞功能测试
  6. 异常场景测试
  7. 测试数据清理
  8. 常见问题

环境准备

1. 数据库准备

确保 PostgreSQL 数据库已启动并创建了 top-fans 数据库：

CREATE DATABASE "top-fans" OWNER haihuizhu ENCODING 'UTF8';

2. 环境变量配置

# Gateway 配置
export SERVER_PORT=8080
export GIN_MODE=debug
export DUBBO_USER_SERVICE_URL="tri://127.0.0.1:20000"
export DUBBO_SOCIAL_SERVICE_URL="tri://127.0.0.1:20001"
export DUBBO_ASSET_SERVICE_URL="tri://127.0.0.1:20002"
export JWT_SECRET="topfans-secret-key-please-change-in-production"

3. 工具准备

推荐使用以下工具之一进行API测试：

  • Postman (推荐)
  • curl 命令行
  • HTTPie
  • Insomnia

4. 测试数据准备

确保数据库中有明星数据：

-- 肖战（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)
ON CONFLICT (star_id) DO NOTHING;

-- 王一博（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)
ON CONFLICT (star_id) DO NOTHING;

服务启动

1. 启动 UserService

cd /Users/haihuizhu/infinite_matrix/TopFans/backend/services/userService
go run main.go

预期输出：

Starting User Service...
Dubbo-go service started successfully. Press Ctrl+C to exit.

检查端口：

lsof -i :20000

2. 启动 SocialService

cd /Users/haihuizhu/infinite_matrix/TopFans/backend/services/socialService
go run main.go

预期输出：

Starting Social Service...
Social service started successfully. Press Ctrl+C to exit.

检查端口：

lsof -i :20001

3. 启动 AssetService

cd /Users/haihuizhu/infinite_matrix/TopFans/backend/services/assetService
go run main.go

预期输出：

Starting Asset Service...
Asset Service started successfully on port 20002

检查端口：

lsof -i :20002

4. 启动 Gateway

cd /Users/haihuizhu/infinite_matrix/TopFans/backend/gateway
go run main.go

预期输出：

Starting Top-Fans Gateway...
Gateway server started successfully

检查端口：

lsof -i :8080

5. 健康检查

curl http://localhost:8080/health

预期响应：

{
  "status": "ok",
  "service": "top-fans-gateway"
}

用户准备

步骤 1: 注册用户 A（张三）

curl -X POST http://localhost:8080/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "13800000001",
    "password": "password123",
    "star_id": 87,
    "nickname": "张三"
  }'

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "token_expires_at": 1736234567890,
    "user": {
      "id": 1,
      "mobile": "13800000001",
      "avatar_url": "",
      "is_active": true
    },
    "fan_profile": {
      "id": 1,
      "user_id": 1,
      "star_id": 87,
      "nickname": "张三",
      "level": 1,
      "social": 0
    }
  }
}

保存变量：

export USER_A_ID=1
export USER_A_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

步骤 2: 注册用户 B（李四）

curl -X POST http://localhost:8080/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "13800000002",
    "password": "password123",
    "star_id": 87,
    "nickname": "李四"
  }'

保存变量：

export USER_B_ID=2
export USER_B_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

步骤 3: 注册用户 C（王五）

curl -X POST http://localhost:8080/api/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{
    "mobile": "13800000003",
    "password": "password123",
    "star_id": 87,
    "nickname": "王五"
  }'

保存变量：

export USER_C_ID=3
export USER_C_TOKEN="eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

资产功能测试

API 概览

序号 功能 方法 路径 说明
1 上传图片 POST /api/v1/assets/upload 上传藏品图片（返回URL）
2 创建铸造订单 POST /api/v1/assets/mints 创建资产并发起铸造
3 取消铸造订单 DELETE /api/v1/assets/mints/{order_id} 取消铸造订单（不退回水晶）
4 获取我的藏品列表 GET /api/v1/assets/me/items 获取当前用户的藏品列表（含点赞数）
5 获取资产详情 GET /api/v1/assets/{asset_id} 获取资产详细信息（仅限自己的资产）
6 查询上链状态 GET /api/v1/assets/{asset_id}/status 查询资产上链状态（仅限自己的资产）

测试场景 0: 上传图片（可选）

0.1 上传封面图片

curl -X POST http://localhost:8080/api/v1/assets/upload \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${USER_A_TOKEN}" \
  -d '{
    "image_url": "https://example.com/images/cover1.jpg",
    "type": "cover"
  }'

请求参数说明：

  • image_url (必填): 图片URL
  • type (可选): 图片类型，可选值：cover(封面，默认) 或 material(素材)

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "pic_url": "https://example.com/images/cover1.jpg",
    "upload_id": "upload_1736234567_abc12345"
  }
}

说明： 目前直接返回原URL，后续可扩展图片审核、AI处理等功能。

测试场景 1: 创建铸造订单

1.1 张三创建第一个资产（包含所有可选参数）

curl -X POST http://localhost:8080/api/v1/assets/mints \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${USER_A_TOKEN}" \
  -d '{
    "name": "肖战的第一个藏品",
    "cover_url": "https://example.com/images/cover1.jpg",
    "material_url": "https://example.com/materials/material1.jpg",
    "description": "这是张三创建的第一个藏品，非常珍贵！",
    "rarity": 5,
    "tags": ["限量", "珍藏", "肖战"]
  }'

请求参数说明：

  • name (必填): 藏品名称
  • cover_url (必填): 封面图URL
  • material_url (可选): 用户上传的素材URL
  • description (可选): 藏品描述
  • rarity (可选): 稀有度（整数）
  • tags (可选): 标签列表（字符串数组）

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "order": {
      "order_id": "550e8400-e29b-41d4-a716-446655440000",
      "user_id": 1,
      "asset_id": 1,
      "star_id": 87,
      "status": "PENDING",
      "cost_crystal": 100,
      "retry_count": 0,
      "created_at": 1736234567890,
      "updated_at": 1736234567890
    },
    "asset": {
      "asset_id": 1,
      "owner_uid": 1,
      "star_id": 87,
      "name": "肖战的第一个藏品",
      "cover_url": "https://example.com/images/cover1.jpg",
      "material_url": "https://example.com/materials/material1.jpg",
      "description": "这是张三创建的第一个藏品，非常珍贵！",
      "rarity": 5,
      "tags": ["限量", "珍藏", "肖战"],
      "status": 0,
      "like_count": 0,
      "created_at": 1736234567890,
      "updated_at": 1736234567890
    }
  }
}

保存变量：

export ASSET_A1_ID=1
export ORDER_A1_ID="550e8400-e29b-41d4-a716-446655440000"

1.2 张三创建第二个资产（仅必填参数）

curl -X POST http://localhost:8080/api/v1/assets/mints \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${USER_A_TOKEN}" \
  -d '{
    "name": "肖战的第二个藏品",
    "cover_url": "https://example.com/images/cover2.jpg"
  }'

说明： 此请求仅包含必填参数 name 和 cover_url，其他参数均为可选。

保存变量：

export ASSET_A2_ID=2

1.3 李四创建资产

curl -X POST http://localhost:8080/api/v1/assets/mints \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${USER_B_TOKEN}" \
  -d '{
    "name": "李四的珍藏",
    "cover_url": "https://example.com/images/cover3.jpg",
    "description": "这是李四创建的藏品",
    "rarity": 4,
    "tags": ["珍藏"]
  }'

保存变量：

export ASSET_B1_ID=3

测试场景 2: 取消铸造订单

2.1 张三取消第二个铸造订单

curl -X DELETE "http://localhost:8080/api/v1/assets/mints/${ORDER_A2_ID}" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "order_id": "550e8400-e29b-41d4-a716-446655440001",
    "status": "CANCELLED"
  }
}

说明：

  • 只有 PENDING 或 FAILED 状态的订单才能取消
  • 取消订单不会退回已扣除的水晶
  • 取消后订单状态变为 CANCELLED

测试场景 3: 获取我的藏品列表

3.1 获取张三的藏品列表（默认分页）

curl -X GET "http://localhost:8080/api/v1/assets/me/items" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "items": [
      {
        "asset_id": 2,
        "name": "肖战的第二个藏品",
        "cover_url": "https://example.com/images/cover2.jpg",
        "status": "pending",
        "created_at": 1736234600000,
        "minted_at": 0,
        "like_count": 0
      },
      {
        "asset_id": 1,
        "name": "肖战的第一个藏品",
        "cover_url": "https://example.com/images/cover1.jpg",
        "status": "pending",
        "created_at": 1736234567890,
        "minted_at": 0,
        "like_count": 0
      }
    ],
    "total": 2,
    "page": 1,
    "page_size": 20,
    "has_more": false
  }
}

2.2 获取张三的藏品列表（分页查询）

curl -X GET "http://localhost:8080/api/v1/assets/me/items?page=1&page_size=1" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "items": [
      {
        "asset_id": 2,
        "name": "肖战的第二个藏品",
        "cover_url": "https://example.com/images/cover2.jpg",
        "status": "pending",
        "created_at": 1736234600000,
        "minted_at": 0
      }
    ],
    "total": 2,
    "page": 1,
    "page_size": 1,
    "has_more": true
  }
}

2.3 按状态筛选藏品

curl -X GET "http://localhost:8080/api/v1/assets/me/items?status=pending" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

2.4 关键词搜索藏品

curl -X GET "http://localhost:8080/api/v1/assets/me?keyword=第一个" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "items": [
      {
        "asset_id": 1,
        "name": "肖战的第一个藏品",
        "cover_url": "https://example.com/images/cover1.jpg",
        "status": "pending",
        "created_at": 1736234567890,
        "minted_at": 0
      }
    ],
    "total": 1,
    "page": 1,
    "page_size": 20,
    "has_more": false
  }
}

2.5 按创建时间排序

# 降序（默认）
curl -X GET "http://localhost:8080/api/v1/assets/me?sort=created_at_desc" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

# 升序
curl -X GET "http://localhost:8080/api/v1/assets/me?sort=created_at_asc" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

# 按名称排序
curl -X GET "http://localhost:8080/api/v1/assets/me?sort=name_asc" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

测试场景 4: 获取资产详情

3.1 获取张三的第一个资产详情

curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_A1_ID}" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "asset_id": 1,
    "owner_uid": 1,
    "star_id": 87,
    "name": "肖战的第一个藏品",
    "cover_url": "https://example.com/images/cover1.jpg",
    "material_url": "https://example.com/materials/material1.jpg",
    "description": "这是张三创建的第一个藏品，非常珍贵！",
    "rarity": 5,
    "tags": ["限量", "珍藏", "肖战"],
    "visibility": "public",
    "status": 0,
    "like_count": 0,
    "created_at": 1736234567890,
    "updated_at": 1736234567890,
    "minted_at": 0,
    "owner": {
      "user_id": 1,
      "nickname": "张三",
      "avatar": ""
    },
    "is_liked": false
  }
}

3.2 尝试获取别人的资产（应该失败）

curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_B1_ID}" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 403,
  "message": "You can only view your own assets",
  "data": null
}

测试场景 5: 查询上链状态

4.1 查询资产上链状态

curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_A1_ID}/status" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "asset_id": 1,
    "status": "pending",
    "tx_hash": "",
    "block_number": 0,
    "minted_at": 0,
    "error_message": ""
  }
}

点赞功能测试

API 概览

序号 功能 方法 路径 说明
1 点赞资产 POST /api/v1/social/assets/{asset_id}/like 点赞指定资产
2 取消点赞 DELETE /api/v1/social/assets/{asset_id}/like 取消点赞指定资产
3 检查是否已点赞 GET /api/v1/social/assets/{asset_id}/like 检查当前用户是否已点赞该资产

测试场景 1: 点赞资产

1.1 李四点赞张三的第一个资产

curl -X POST "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_B_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "asset_id": 1,
    "new_like_count": 1,
    "is_liked": true
  }
}

1.2 王五点赞张三的第一个资产

curl -X POST "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_C_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "asset_id": 1,
    "new_like_count": 2,
    "is_liked": true
  }
}

1.3 张三自己点赞自己的资产

curl -X POST "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "asset_id": 1,
    "new_like_count": 3,
    "is_liked": true
  }
}

1.4 验证资产详情中的点赞数

curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_A1_ID}" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应（部分）：

{
  "code": 200,
  "message": "ok",
  "data": {
    "asset_id": 1,
    "like_count": 3,
    "is_liked": true
  }
}

测试场景 2: 检查是否已点赞

2.1 李四检查是否已点赞

curl -X GET "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_B_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "is_liked": true
  }
}

2.2 未点赞的用户检查（应该返回 false）

# 假设有一个新用户 USER_D，未点赞该资产
curl -X GET "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_D_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "is_liked": false
  }
}

测试场景 3: 取消点赞

3.1 李四取消点赞

curl -X DELETE "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_B_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "asset_id": 1,
    "new_like_count": 2,
    "is_liked": false
  }
}

3.2 验证点赞数已减少

curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_A1_ID}" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应（部分）：

{
  "code": 200,
  "message": "ok",
  "data": {
    "asset_id": 1,
    "like_count": 2,
    "is_liked": true
  }
}

3.3 再次检查李四的点赞状态

curl -X GET "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_B_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "is_liked": false
  }
}

测试场景 4: 重复点赞处理

4.1 尝试重复点赞（应该返回已点赞状态）

# 王五已经点赞过，再次点赞
curl -X POST "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_C_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "Asset already liked by this user",
  "data": {
    "asset_id": 1,
    "new_like_count": 2,
    "is_liked": true
  }
}

测试场景 5: 取消未点赞的资产

5.1 尝试取消未点赞的资产

# 李四已经取消点赞，再次取消
curl -X DELETE "http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like" \
  -H "Authorization: Bearer ${USER_B_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "Asset not liked by this user",
  "data": {
    "asset_id": 1,
    "new_like_count": 2,
    "is_liked": false
  }
}

测试场景 6: 多个资产的点赞测试

6.1 李四点赞张三的第二个资产

curl -X POST "http://localhost:8080/api/v1/social/assets/${ASSET_A2_ID}/like" \
  -H "Authorization: Bearer ${USER_B_TOKEN}"

6.2 王五点赞张三的第二个资产

curl -X POST "http://localhost:8080/api/v1/social/assets/${ASSET_A2_ID}/like" \
  -H "Authorization: Bearer ${USER_C_TOKEN}"

6.3 验证两个资产的点赞数

# 资产1的点赞数
curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_A1_ID}" \
  -H "Authorization: Bearer ${USER_A_TOKEN}" | jq '.data.like_count'

# 资产2的点赞数
curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_A2_ID}" \
  -H "Authorization: Bearer ${USER_A_TOKEN}" | jq '.data.like_count'

异常场景测试

异常场景 1: 未授权访问

1.1 未登录创建资产

curl -X POST http://localhost:8080/api/v1/assets/mints \
  -H "Content-Type: application/json" \
  -d '{
    "name": "测试资产",
    "cover_url": "https://example.com/images/test.jpg"
  }'

预期响应：

{
  "code": 401,
  "message": "Unauthorized",
  "data": null
}

1.2 未登录点赞资产

curl -X POST "http://localhost:8080/api/v1/social/assets/1/like"

预期响应：

{
  "code": 401,
  "message": "Unauthorized",
  "data": null
}

异常场景 2: 无效的资产ID

2.1 获取不存在的资产详情

curl -X GET "http://localhost:8080/api/v1/assets/99999" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 404,
  "message": "Asset not found",
  "data": null
}

2.2 点赞不存在的资产

curl -X POST "http://localhost:8080/api/v1/social/assets/99999/like" \
  -H "Authorization: Bearer ${USER_B_TOKEN}"

预期响应：

{
  "code": 404,
  "message": "Asset not found",
  "data": null
}

异常场景 3: 访问别人的资产

3.1 尝试获取别人的资产详情

curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_B1_ID}" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 403,
  "message": "You can only view your own assets",
  "data": null
}

3.2 尝试查询别人的资产状态

curl -X GET "http://localhost:8080/api/v1/assets/${ASSET_B1_ID}/status" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 403,
  "message": "You can only view your own assets",
  "data": null
}

异常场景 4: 无效的请求参数

4.1 创建资产时缺少必填字段

curl -X POST http://localhost:8080/api/v1/assets/mints \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${USER_A_TOKEN}" \
  -d '{
    "name": "测试资产"
  }'

预期响应：

{
  "code": 400,
  "message": "cover_url is required",
  "data": null
}

4.2 无效的分页参数

curl -X GET "http://localhost:8080/api/v1/assets/me?page=-1&page_size=0" \
  -H "Authorization: Bearer ${USER_A_TOKEN}"

预期响应：

{
  "code": 200,
  "message": "ok",
  "data": {
    "items": [],
    "total": 2,
    "page": 1,
    "page_size": 20,
    "has_more": false
  }
}

说明： 系统会自动修正无效的分页参数。

异常场景 5: 水晶余额不足

5.1 创建资产时水晶不足

前提条件： 用户的水晶余额小于创建资产所需的水晶数（100）

# 假设用户水晶余额为 50
curl -X POST http://localhost:8080/api/v1/assets/mints \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${USER_A_TOKEN}" \
  -d '{
    "name": "测试资产",
    "cover_url": "https://example.com/images/test.jpg"
  }'

预期响应：

{
  "code": 400,
  "message": "Insufficient crystal balance",
  "data": null
}

测试数据清理

清理测试资产

-- 删除测试用户的资产点赞记录
DELETE FROM asset_likes 
WHERE user_id IN (
  SELECT id FROM users WHERE mobile IN ('13800000001', '13800000002', '13800000003')
);

-- 删除测试用户的资产
DELETE FROM assets 
WHERE owner_uid IN (
  SELECT id FROM users WHERE mobile IN ('13800000001', '13800000002', '13800000003')
);

-- 删除测试用户的铸造订单
DELETE FROM mint_orders 
WHERE user_id IN (
  SELECT id FROM users WHERE mobile IN ('13800000001', '13800000002', '13800000003')
);

清理测试用户

-- 删除测试用户的粉丝档案
DELETE FROM fan_profiles 
WHERE user_id IN (
  SELECT id FROM users WHERE mobile IN ('13800000001', '13800000002', '13800000003')
);

-- 删除测试用户
DELETE FROM users 
WHERE mobile IN ('13800000001', '13800000002', '13800000003');

常见问题

Q1: 创建资产时提示 "Insufficient crystal balance"

原因： 用户的水晶余额不足。

解决方案：

  1. 检查用户的水晶余额
  2. 确保用户有足够的水晶（创建资产需要 100 水晶）
  3. 可以通过用户服务接口充值水晶（如果已实现）

Q2: 无法获取别人的资产详情

原因： 系统设计为只能查看自己的资产。

解决方案： 这是正常的安全限制，无法绕过。如果需要查看别人的资产，需要实现新的接口或修改权限控制。

Q3: 点赞数不更新

可能原因：

  1. Asset Service 未启动
  2. Social Service 和 Asset Service 之间的 RPC 调用失败
  3. 数据库事务未提交

解决方案：

  1. 检查所有服务是否正常运行
  2. 查看服务日志，确认 RPC 调用是否成功
  3. 检查数据库连接和事务状态

Q4: 重复点赞返回成功但点赞数未增加

原因： 系统检测到重复点赞，返回成功但不会增加点赞数。

解决方案： 这是正常行为。系统会返回 "message": "Asset already liked by this user"，表示已点赞。

Q5: 资产状态一直是 "pending"

原因： 上链功能可能未实现或正在处理中。

解决方案：

  1. 检查上链服务是否正常运行
  2. 查看订单状态和错误信息
  3. 如果上链功能未实现，这是正常的（设计文档中说明上链为异步处理）

Q6: 分页查询返回的数据顺序不一致

原因： 未指定排序方式。

解决方案： 使用 sort 参数指定排序方式：

  • created_at_desc - 按创建时间降序（默认）
  • created_at_asc - 按创建时间升序
  • name_asc - 按名称升序

完整测试流程总结

推荐测试顺序

  1. 环境准备 → 启动所有服务
  2. 用户准备 → 注册测试用户
  3. 资产创建 → 创建多个测试资产
  4. 资产查询 → 测试列表、详情、状态查询
  5. 点赞功能 → 测试点赞、取消点赞、检查状态
  6. 异常场景 → 测试各种错误情况
  7. 数据清理 → 清理测试数据

测试检查清单

  • 所有服务正常启动
  • 用户注册成功
  • 创建资产成功
  • 获取资产列表成功
  • 获取资产详情成功
  • 点赞资产成功
  • 取消点赞成功
  • 检查点赞状态成功
  • 点赞数正确更新
  • 异常场景处理正确
  • 权限控制正确
  • 数据隔离正确（不同明星的数据互不干扰）

性能测试建议

1. 并发点赞测试

# 使用 Apache Bench 进行并发点赞测试
ab -n 100 -c 10 -H "Authorization: Bearer ${USER_B_TOKEN}" \
  -X POST http://localhost:8080/api/v1/social/assets/${ASSET_A1_ID}/like

2. 大量资产查询测试

创建 100+ 个资产，测试分页查询性能。

3. 点赞数统计测试

创建资产并让多个用户点赞，验证点赞数统计的准确性。

文档版本: v1.0
最后更新: 2026-01-12
维护者: AI Assistant