后端框架 · RuoYi-Vue-Plus框架功能基础功能
客户端管理功能
版本
- 5.X
客户端字段说明
| 字段名称 | 取值说明 | 注意事项 |
|---|---|---|
| 客户端id | 后端生成，用于登录校验与接口数据加密 | 无法修改，不要删除默认数据 |
| 客户端key | 前端自定义 | 无法修改，不要删除默认数据 |
| 客户端秘钥 | 前端自定义 | 无法修改，不要删除默认数据 |
| 授权类型 | 密码/短信/邮件/小程序/第三方认证 | 决定该客户端支持的登录方式 |
| 设备类型 | PC 端 / APP 端 | - |
| Token 活跃超时 | 秒 | 无操作即过期，默认 1800 秒 |
| Token 固定超时 | 秒 | 固定过期时间，默认 604800 秒 |
使用新的客户端 ID
步骤：
- 在客户端管理页面生成新的客户端 ID
- 将 ID 写入前端配置文件
通常对应前端环境变量 VITE_APP_CLIENT_ID，本地开发一般修改 .env.development，生产环境按实际部署环境修改对应 .env 文件。
新增自定义客户端
1. 新增客户端数据
示例：新增小程序端。
2. 配置前端请求头
需要在全局请求头中增加 clientid。
可参考前端 request.ts：
VITE_APP_CLIENT_ID 为配置文件中的客户端 ID。
注意：不同客户端登录后获取的 token 互不通用。
补充说明：
plus-ui的普通接口请求、SSE、WebSocket 等能力都会读取这个客户端 ID- 如果你只改了某个单独页面而没有统一修改环境变量，联调时很容易出现“客户端ID与Token不匹配”
新增自定义登录方式
说明：不要新增独立登录接口，系统统一使用同一登录接口，通过策略扩展鉴权方式。
调试步骤参考：关于登录调试步骤
1. 新增字典数据
2. 新增/修改客户端数据
3. 后端新增认证策略
实现 IAuthStrategy 接口：
参照已有策略实现自定义参数校验与登录逻辑。
注意修改 @Service 名称保证规范性。
LoginBody 校验参数（可自定义）：
示例：扩展小程序登录参数（继承 LoginBody）。
校验分组（可自定义）：
