第2章 用户无法登录管理后台

现象识别

用户无法登录管理后台的典型表现包括：

• 输入正确用户名密码后页面提示“登录失败”或“账户异常”；
• 连续尝试后提示“账号已被锁定，请稍后再试”；
• 登录页面无响应或跳转回登录页（无错误提示）；
• 使用不同浏览器或设备均无法登录。

数据采集

日志是定位根因的关键。按以下位置采集日志：

# 查看最近100条认证失败日志
grep -i "login.*fail\|auth.*error\|locked" /app/logs/auth-service.log | tail -100

原因定位（认证链路分析）

系统认证链路通常经过 客户端 → 负载均衡 → Web应用 → 认证服务 → 数据库/缓存。链路上任意节点故障都会导致登录失败。下面通过故障树辅助定位：

修复动作：账号锁定修复

确认账号被锁定后，按以下步骤修复：

1. 查询锁定状态：通过管理工具或API查询用户锁定情况。示例：

   curl -X GET "https://admin.example.com/api/v1/users/lock-status?username=张三" -H "Authorization: Bearer {token}"

2. 解锁账号：执行解锁操作（管理后台或命令行）：

   # 假设使用Admin API
   curl -X POST "https://admin.example.com/api/v1/users/unlock" \
     -H "Authorization: Bearer {token}" \
     -H "Content-Type: application/json" \
     -d '{"username":"张三"}'

3. 清除锁定计数：锁定策略通常基于失败次数。解锁后需清除缓存中的计数。若使用Redis：

   redis-cli DEL "lock:count:张三"

4. 通知用户：告知用户已解锁，建议修改密码并避免连续输错。

复测步骤

1. 请用户使用正确密码尝试登录，观察是否成功进入管理后台。
2. 检查认证日志，确认不再出现 AccountLocked 或 InvalidCredentials 错误。
3. 模拟错误密码输入（3次以内），检查系统不再触发锁定（若锁定阈值未达到）。
4. 验证其他原有功能是否正常（如权限、菜单加载）。

预防清单