Skip to content

动态配置管理

动态配置管理模块允许管理员在运行时修改系统参数,无需重启服务即可生效,支持 @RefreshScope 热刷新机制。

功能入口

登录管理后台后,点击左侧菜单 系统管理 > 参数配置,进入参数配置列表页面。页面以表格形式展示所有配置项,包含参数名称、参数键名、参数值、状态等字段。

系统参数列表

列表展示所有可动态管理的系统参数,支持按参数名称参数键名搜索。配置项包括系统默认密码、文件上传大小限制、验证码开关等全局参数。

新增配置项

  1. 在参数配置列表页右上角,点击 新增 按钮
  2. 弹出新增配置项表单,填写:
    • 参数名称(必填):配置项的中文名称,如"用户默认密码"
    • 参数键名(必填):后端读取的 key,如 sys.user.initPassword
    • 参数值(必填):配置的当前值,如 123456
    • 系统内置:是 / 否,内置配置不允许删除
    • 备注:配置项说明
  3. 点击 确定 完成创建

编辑配置值

  1. 在配置列表中点击目标配置项操作列的 编辑 链接
  2. 修改参数值
  3. 点击 确定,配置立即生效

@RefreshScope 热刷新

Forge Admin 基于 Spring Cloud 的 @RefreshScope 实现了配置热刷新:

  • 通过页面修改配置后,配置值立即更新到数据库
  • 标注了 @RefreshScope 的 Bean 会在下次请求时重新初始化
  • 无需重启服务,无需重新部署
  • 适用于开关类配置(如验证码开关、注册开关)和阈值类配置(如上传大小限制)

常用配置示例

参数名称参数键名示例值说明
用户默认密码sys.user.initPassword123456新增用户默认密码
验证码开关sys.account.captchaEnabledtrue登录是否启用验证码
注册开关sys.account.registerEnabledfalse是否开放用户注册
文件上传大小sys.file.maxSize10MB文件上传大小限制

注意事项

  • 内置配置项(系统预置)不可删除,仅可修改参数值
  • 参数键名创建后不可修改
  • 热刷新仅对标注 @RefreshScope 的 Bean 生效,硬编码读取需重启

相关文档

Forge Admin — 基于 Vue3 + Spring Boot 的企业级后台管理框架