已知限制
了解 Forge Admin 当前架构下的已知约束,可以帮助你做出更合理的技术决策。
内置 Plugin 需编译期装配
现状:框架自带的 forge-plugin-* 通过 Maven 依赖写进 forge-admin-server/pom.xml,启动时由 Spring Boot 自动装配。这不是运行时从注册中心热插拔 JAR。
影响:增删内置 Plugin,需要改 pom.xml 并重新构建。
与源码插件的区别:外购/自研的源码插件走后台 插件中心(安装、构建任务、制品与交付),见 源码插件购买与安装。那是另一条交付链路,不要和「改 pom 装内置模块」混为一谈。
替代方案:不需要某个内置 Plugin 时,在 pom.xml 中排除对应依赖即可。
Admin 与 Flow 通过固定 URL 通信
现状:Admin 通过 forge-flow-client 的 FlowClient(底层 RestTemplate)按配置项 forge.flow.client.url 调用 Flow 服务。这是多进程 HTTP 调用,不是 Feign,也不依赖 Nacos / Eureka 等服务注册中心。
影响:只启动 Admin、不启动 Flow,或 forge.flow.client.url 指错端口时,工作流相关接口会失败。官方本地 Flow 端口是 8081。
替代方案:开发时按需启动 Flow;生产用 Nginx / Compose 把 Admin 与 Flow 配通,并保证 forge.flow.client.url 指向可达地址。详见 流程客户端 与部署篇 Admin↔Flow 说明。
大屏暂不内置数据源管理
现状:forge-report-server 当前版本支持外部数据源对接,但数据源配置需要通过配置文件或 API 手动设置,暂未内置可视化的数据源管理界面。
影响:配置数据大屏的数据源时需要手动操作,无法在 UI 中直观管理。
预计解决:Q3 2026 计划实现内置数据源管理。
其他限制
| 限制 | 说明 | 影响范围 |
|---|---|---|
| 单数据源主库 | 所有业务表部署在同一 MySQL 实例 | 高并发场景需考虑读写分离 |
| 前端 Monolith | 管理端是一个 SPA 应用,不支持微前端 | 超大型项目可能需要额外拆分 |
| IDE 要求 | 推荐 IntelliJ IDEA(插件格式化已配置) | 其他 IDE 可能需要手动配置 |
| 中文优先 | 默认时区 Asia/Shanghai,字典中文 | 国际化需要额外适配 |
已知问题的反馈
如果你在使用过程中遇到其他限制或问题,可以通过以下方式反馈:
- Gitee Issue:https://gitee.com/ForgeLab/forge-admin/issues
- 社区反馈:文档站内的社区反馈渠道
- 产品路线图:查看产品路线图了解规划中的改进
