---
description: 记录用户登录失败次数、最近失败时间和账号临时锁定状态，用户成功登录后清理。
navTitle: USER_STATUS
---
# **USER\_STATUS 用户状态表**

用户状态表用于记录用户登录安全相关的运行时状态，主要包括登录失败次数、最近一次失败时间以及账号临时锁定截止时间。它用于登录失败锁定、验证码触发和账号安全提示等场景，用户成功登录后会清理这些失败状态。

## 位置{#position}

模型路径：`/sysdata/data/tables/sec/USER_STATUS.tbl`

物理表名：`SZSYS_5_USER_STATUS`

## 表结构{#structure}

| 字段名 | 字段类型 | 字段描述 |
| :----  | :---- | :------ |
| USER\_ID | VARCHAR(64) | 用户ID，主键 |
| LAST\_FAIL\_TIME | TIMESTAMP | 最近一次登录失败时间 |
| FAIL\_TIMES | NUMBER(4) | 登录失败次数 |
| LOCK\_TO\_TIME | TIMESTAMP | 禁止登录截止时间，未锁定时为空 |

## 表索引{#indexes}

| 类型 | 名称 | 字段列表 | 是否唯一 | 说明 |
| :---- | :---- | :---- | :------ | :------ |
| 主键 | PRIMARY | USER\_ID | 是 | 唯一标识一条记录 |
| 索引 | - | - | - | 该表未定义其他索引 |

## 使用注意{#notice}

1. `FAIL_TIMES` 和 `LOCK_TO_TIME` 会影响用户能否继续登录，用户成功登录后会自动清理，人工调整前应确认账号安全风险。
2. `LAST_FAIL_TIME` 用于判断失败行为的时间范围，排查登录异常时可与系统登录日志结合查看。
3. 该表不记录在线状态；在线会话请查看[HTTP Session 持久化存储表](./HTTP_SESSIONS.md)。