用户管理功能
uni-admin 的用户管理模块提供了完整的用户 CRUD 操作,包括新增、删除、修改、分页查询。
新增用户
新增用户时需要填写以下信息:
- 用户名(必填)
- 用户昵称(必填)
- 初始密码(必填,密码强度要求由配置控制)
- 手机号、邮箱(可选)
- 角色列表(下拉选择已有角色)
- 用户标签
- 可登录应用(关键配置)
密码强度在 uni-config-center/uni-id/config.json 的 passwordStrength 字段中配置。设置为 medium 时,要求密码包含字母、数字、特殊符号中至少两种的组合。
可登录应用的重要性
创建用户时,必须勾选"可登录应用"。如果未勾选任何应用,用户虽然创建成功,但无法登录任何客户端。错误提示为"此账号未在该应用注册"。
这是很多开发者遇到的第一个坑——以为创建了用户就能登录,实际上还需要在"应用管理"中注册对应的应用,并在用户配置中勾选该应用。
应用管理
应用管理模块管理整个 uni-admin 平台接入的所有应用。每个应用包含以下信息:
| 数据类别 | 具体字段 |
|---|---|
| 基础信息 | APPID(来自 DCloud 管理后台)、应用名称、应用简介、应用描述 |
| 图标素材 | 应用图标、应用截图 |
| APP 信息 | Android/iOS 下载地址 |
| 小程序信息 | 名称、小程序码 |
新增应用步骤
- 打开 DCloud 开发者中心,获取 uni-starter 项目的 APPID
- 在 uni-admin 的"系统管理 → 应用管理"中点击新增
- 填写 APPID、应用名称、简介、描述
- 上传应用图标和应用截图
- 配置小程序码等平台信息
- 点击保存
图片上传失败的处理
上传应用图标或截图后,如果图片显示为空白,通常是因为云存储未配置跨域资源访问(CORS)。
解决方法:
- 打开 DCloud 云端控制台
- 进入云服务空间 → 云存储
- 点击左侧的"跨域配置"
- 新增域名,填写
localhost:5173(开发环境的本地地址) - 配置成功后,重新上传图片即可正常显示
用户与应用的打通
完成应用注册后,需要将用户与应用关联起来:
- 在"用户管理"中找到目标用户
- 点击修改
- 在"可登录应用"中勾选已注册的应用(如 uni-starter)
- 提交保存
配置完成后,该用户就可以在 uni-starter 客户端使用账号密码登录。登录成功后,客户端首页会根据用户信息展示对应的个性化内容(如显示登录用户的宫格模块)。
关键配置链路
用户能够成功登录前端应用,需要完成以下配置链路:
1. 云空间配置安全密钥(uni-id/config.json)
↓
2. 注册超级管理员账号
↓
3. 应用管理中新增前端应用(获取 APPID)
↓
4. 云存储配置跨域访问(解决图片加载问题)
↓
5. 用户管理中创建用户并勾选"可登录应用"
↓
6. 前端客户端使用该账号登录
text
这个链路中任何一个环节缺失都会导致登录失败或功能异常。其中最容易遗漏的是第 4 步(跨域配置)和第 5 步(可登录应用勾选)。
↑