Skip to content

已知限制 ​

了解 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,字典中文国际化需要额外适配

已知问题的反馈 ​

如果你在使用过程中遇到其他限制或问题,可以通过以下方式反馈: