chengshishouce/TESTING.md

API 测试指南

测试后端 API

1. 获取 Token (登录)

curl -X POST http://localhost:8000/api/auth/login/ \
  -H "Content-Type: application/json" \
  -d '{
    "email": "your@email.com",
    "password": "your_password"
  }'

响应示例：

{
  "access": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "user": {
    "id": 1,
    "email": "your@email.com",
    "username": "your_username",
    "first_name": "First",
    "last_name": "Last"
  }
}

2. 刷新 Token

curl -X POST http://localhost:8000/api/auth/token/refresh/ \
  -H "Content-Type: application/json" \
  -d '{
    "refresh": "your_refresh_token"
  }'

3. 获取用户列表 (需要认证)

curl -X GET http://localhost:8000/api/users/ \
  -H "Authorization: Bearer your_access_token"

4. 获取当前用户

curl -X GET http://localhost:8000/api/users/me/ \
  -H "Authorization: Bearer your_access_token"

GraphQL 测试

访问 http://localhost:8000/graphql/?graphiql

查询所有用户

query {
  allUsers {
    id
    email
    username
    firstName
    lastName
  }
}

查询当前用户

query {
  me {
    id
    email
    username
    firstName
    lastName
  }
}

Postman 集合

你可以导入以下 Postman 集合来测试 API：

环境变量

• base_url: http://localhost:8000
• access_token: (登录后自动填充)

请求示例

1. 登录

• Method: POST
• URL: {{base_url}}/api/auth/login/
• Body:

{
  "email": "test@example.com",
  "password": "testpass123"
}

• Tests (自动提取 token):

var jsonData = pm.response.json();
pm.environment.set("access_token", jsonData.access);

2. 获取用户

• Method: GET
• URL: {{base_url}}/api/users/
• Headers:

Authorization: Bearer {{access_token}}

3. 获取当前用户

• Method: GET
• URL: {{base_url}}/api/users/me/
• Headers:

Authorization: Bearer {{access_token}}

自动化测试

后端测试

cd backend
python manage.py test

前端测试

cd frontend
npm test

常见错误

401 Unauthorized

• Token 过期，使用 refresh_token 刷新
• Token 格式错误，确保 Bearer 前缀存在
• Token 被吊销

403 Forbidden

• 权限不足，检查用户是否有相应权限
• CSRF token 问题（开发环境可能遇到）

404 Not Found

• 端点不存在，检查 URL 路径
• 检查 Django 是否正确启动

500 Server Error

• 检查 Django 日志
• 检查数据库连接
• 检查代码语法错误