happy-life-star/backend-single/docs/ADMIN_AUTH_TEST.md

管理员登录功能测试指南

测试前准备

1. 执行数据库脚本

确保已执行 sql/emotion_museum.sql 脚本，该脚本会：

• 创建 t_admin 表
• 初始化默认管理员账号

2. 启动应用

cd backend-single
mvn spring-boot:run

测试用例

测试1: 管理员登录

请求:

curl -X POST http://localhost:8080/api/admin/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "account": "admin",
    "password": "admin123"
  }'

预期响应:

{
  "code": 200,
  "message": "登录成功",
  "data": {
    "accessToken": "eyJhbGciOiJIUzUxMiJ9...",
    "refreshToken": "eyJhbGciOiJIUzUxMiJ9...",
    "expiresIn": 86400,
    "adminInfo": {
      "id": "xxx",
      "account": "admin",
      "username": "系统管理员",
      "email": "admin@emotion-museum.com",
      "phone": "13800138000",
      "role": "super_admin",
      "status": 1
    },
    "loginTime": "2025-10-27 10:00:00"
  },
  "timestamp": 1698393600000
}

测试2: 错误的密码

请求:

curl -X POST http://localhost:8080/api/admin/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "account": "admin",
    "password": "wrongpassword"
  }'

预期响应:

{
  "code": 500,
  "message": "账号或密码错误",
  "data": null,
  "timestamp": 1698393600000
}

测试3: 获取管理员信息

请求:

curl -X GET http://localhost:8080/api/admin/auth/info \
  -H "Authorization: Bearer {从登录接口获取的accessToken}"

预期响应:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "id": "xxx",
    "account": "admin",
    "username": "系统管理员",
    "email": "admin@emotion-museum.com",
    "role": "super_admin",
    "status": 1
  },
  "timestamp": 1698393600000
}

测试4: 访问管理员接口（分页查询管理员）

请求:

curl -X GET "http://localhost:8080/api/admin/page?current=1&size=10" \
  -H "Authorization: Bearer {accessToken}"

预期响应:

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "records": [
      {
        "id": "xxx",
        "account": "admin",
        "username": "系统管理员",
        "role": "super_admin",
        ...
      }
    ],
    "total": 1,
    "current": 1,
    "size": 10,
    "pages": 1
  },
  "timestamp": 1698393600000
}

测试5: 普通用户Token访问管理员接口（应该被拒绝）

请求:

# 先用普通用户登录获取Token
curl -X POST http://localhost:8080/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "13800138001",
    "smsCode": "123456"
  }'

# 使用普通用户Token访问管理员接口
curl -X GET http://localhost:8080/api/admin/page \
  -H "Authorization: Bearer {普通用户的accessToken}"

预期响应:

{
  "code": 403,
  "message": "无权限访问",
  "data": null
}

测试6: 管理员登出

请求:

curl -X POST http://localhost:8080/api/admin/auth/logout \
  -H "Authorization: Bearer {accessToken}"

预期响应:

{
  "code": 200,
  "message": "登出成功",
  "data": null,
  "timestamp": 1698393600000
}

测试7: 刷新Token

请求:

curl -X POST http://localhost:8080/api/admin/auth/refreshToken \
  -H "Content-Type: application/json" \
  -d '{
    "refreshToken": "{从登录接口获取的refreshToken}"
  }'

预期响应:

{
  "code": 200,
  "message": "令牌刷新成功",
  "data": {
    "accessToken": "新的accessToken",
    "refreshToken": "新的refreshToken",
    "expiresIn": 86400,
    ...
  },
  "timestamp": 1698393600000
}

使用Postman测试

1. 导入环境变量

创建环境变量：

• baseUrl: http://localhost:8080/api
• adminToken: (登录后自动设置)

2. 管理员登录请求配置

• Method: POST
• URL: {{baseUrl}}/admin/auth/login
• Headers:
  • Content-Type: application/json
• Body (raw JSON):

{
  "account": "admin",
  "password": "admin123"
}

• Tests (自动保存Token):

if (pm.response.code === 200) {
    const response = pm.response.json();
    pm.environment.set("adminToken", response.data.accessToken);
}

3. 其他请求配置

在需要认证的请求中添加Header：

• Key: Authorization
• Value: Bearer {{adminToken}}

验证要点

1. ✅ 管理员可以使用账号密码登录
2. ✅ 登录成功返回带有userType=admin的Token
3. ✅ 管理员Token可以访问 /admin/** 路径
4. ✅ 普通用户Token无法访问管理员接口（返回403）
5. ✅ 管理员Token无法访问普通用户接口
6. ✅ 登录信息被正确记录（最后登录时间、登录次数）
7. ✅ Token刷新功能正常
8. ✅ 登出功能正常

常见问题

Q1: 登录返回401

原因: 账号或密码错误 解决: 检查账号密码是否正确，确认数据库中有初始管理员数据

Q2: 访问接口返回403

原因: 使用了错误类型的Token 解决: 确保使用管理员Token访问管理员接口

Q3: Token验证失败

原因: Token过期或无效 解决: 重新登录或使用refreshToken刷新

Q4: 数据库连接失败

原因: Redis或MySQL未启动 解决: 确保Redis和MySQL服务正常运行