已知限制
了解 Forge Admin 当前架构下的已知约束,可以帮助你做出更合理的技术决策。
Plugin 不支持运行时热插拔
现状:Plugin 的加载方式是 Maven 模块化组合,在 forge-admin-server/pom.xml 中通过依赖引入决定包含哪些 Plugin。不支持运行时动态加载或卸载。
影响:要增删 Plugin,需要修改 pom.xml 并重新构建项目。
替代方案:如果不需要某个 Plugin 的功能,可以在 pom.xml 中排除对应依赖即可。
Feign 调用依赖服务注册
现状:Admin 服务与 Flow 服务之间的通信通过 Feign 客户端实现,依赖 Spring Cloud 的服务注册与发现机制。
影响:在开发环境中,如果只运行 Admin 服务不运行 Flow 服务,调用工作流相关接口会失败。
替代方案:开发时按需启动 Flow 服务;生产环境建议通过 Nginx 路由 Fallback 或使用统一的注册中心。
大屏暂不内置数据源管理
现状: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
- 社区反馈:文档站内的社区反馈渠道
- 产品路线图:查看产品路线图了解规划中的改进
