动态配置管理
这篇对应后台 参数配置 菜单（键值参数表），不是「系统配置」页签中心。系统核心开关见 系统配置。
动态配置管理模块允许管理员在运行时修改系统参数，无需重启服务即可生效，支持 @RefreshScope 热刷新机制。
功能入口
登录后点 平台管理 → 基础配置 → 参数设置（路由 /system/config）。系统配置中心是另一页：/system/config-center。
2026-08-26 演示站实拍。搜索：参数名称、参数键名、系统内置。主按钮是 新增配置 / 批量删除。列表列：参数、参数键值、系统内置、排序、参数描述、创建时间、操作。行操作是 编辑 / 删除。参数列同时显示名称和键名。
系统参数列表
演示站可见键包括：sys.user.initPassword（用户初始密码，值脱敏）、sys.account.registerUser（账号自助注册）、sys.export.async.threshold、sys.export.batch.size、sys.export.file.keepHours、business.datasource.tenant-routing-enabled（业务租户数据源路由开关）。
新增配置项
点 新增配置。
2026-08-26 演示站实拍。
| 字段 | 必填 | 说明 |
|---|---|---|
| 参数名称 | 是 | |
| 参数键名 | 是 | 如 sys.login.timeout |
| 参数键值 | 是 | 界面叫参数键值，不是「参数值」 |
| 系统内置 | 是 | 是 / 否。内置项不能删 |
| 排序 | 否 | |
| 参数描述 | 否 |
编辑配置值
- 在配置列表中点击目标配置项操作列的 编辑 链接
- 修改参数值
- 点击 确定，配置立即生效
@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 生效，硬编码读取需重启