动态配置管理
动态配置管理模块允许管理员在运行时修改系统参数,无需重启服务即可生效,支持 @RefreshScope 热刷新机制。
功能入口
登录管理后台后,点击左侧菜单 系统管理 > 参数配置,进入参数配置列表页面。页面以表格形式展示所有配置项,包含参数名称、参数键名、参数值、状态等字段。
系统参数列表
列表展示所有可动态管理的系统参数,支持按参数名称和参数键名搜索。配置项包括系统默认密码、文件上传大小限制、验证码开关等全局参数。
新增配置项
- 在参数配置列表页右上角,点击 新增 按钮
- 弹出新增配置项表单,填写:
- 参数名称(必填):配置项的中文名称,如"用户默认密码"
- 参数键名(必填):后端读取的 key,如
sys.user.initPassword - 参数值(必填):配置的当前值,如
123456 - 系统内置:是 / 否,内置配置不允许删除
- 备注:配置项说明
- 点击 确定 完成创建
编辑配置值
- 在配置列表中点击目标配置项操作列的 编辑 链接
- 修改参数值
- 点击 确定,配置立即生效
@RefreshScope 热刷新
Forge Admin 基于 Spring Cloud 的 @RefreshScope 实现了配置热刷新:
- 通过页面修改配置后,配置值立即更新到数据库
- 标注了
@RefreshScope的 Bean 会在下次请求时重新初始化 - 无需重启服务,无需重新部署
- 适用于开关类配置(如验证码开关、注册开关)和阈值类配置(如上传大小限制)
常用配置示例
| 参数名称 | 参数键名 | 示例值 | 说明 |
|---|---|---|---|
| 用户默认密码 | sys.user.initPassword | 123456 | 新增用户默认密码 |
| 验证码开关 | sys.account.captchaEnabled | true | 登录是否启用验证码 |
| 注册开关 | sys.account.registerEnabled | false | 是否开放用户注册 |
| 文件上传大小 | sys.file.maxSize | 10MB | 文件上传大小限制 |
注意事项
- 内置配置项(系统预置)不可删除,仅可修改参数值
- 参数键名创建后不可修改
- 热刷新仅对标注
@RefreshScope的 Bean 生效,硬编码读取需重启
