跳到主内容

DataGear 升级到 6.1 救不了你的看板?先看这次大版本到底动了什么

一个 6 年多的开源 BI 平台,版本号从 5.5.0 跳到 6.0.0 隔了 11 个月,6.0.0 到 6.1.0 又隔 3 个月,而 6.1.0 到 6.1.1 只隔 15 天。这个节奏说明:大版本攒的是重构,小版本补的是重构漏出来的洞。我把 6.1.1 的包下下来在本机跑了一遍,把升级路径上几个不明显的地方记下来。

项目背景与目标

DataGear 是国产开源数据可视化平台,单体 Java 应用,后端 Spring Boot + MyBatis + Freemarker,前端 jQuery + Vue3 + ECharts,内置数据库用 Derby。链路是数据源 → 数据集 → 图表 → 看板,数据集支持 SQL、HTTP、CSV、Excel、JSON 六种来源,内置 70 多个图表,看板模板本身就是原生 HTML,能直接塞 Vue。仓库在 Gitee,6,882 star、2,571 fork,GPL-3.0。

6.x 的目标写在 6.0.0 第一条更新里:看板新增 API-2.0 环境,全新重构看板 API 以及内置图表插件。不是加功能,是把看板那层地基换了。界面看着一样,插件接口和图表配置结构却可能变。

约束条件

三条硬约束先说清。运行时只要 JDK 8+,包内自带 Tomcat;数据默认全落在 [用户主目录]/.datagear,配置里 DATAGEAR_HOME 一改等于换一套新数据;授权 GPL-3.0,官方另有企业版 1.5.0,规划预算发票那些在付费侧。

还有一条影响复现的:官方文档站正文页现在打不开,/docs/ 目录页能进,点进去的 installation.html 返回 {"status":404}。所以下面的参数不是抄文档,是从安装包的 readme.txt 和 config/application.properties 注释里读的——反而更靠谱,那才是程序真正读的东西。

执行过程

包从 Gitee Release 下,datagear-6.1.1.zip,69,254,080 字节。解开就五个东西:datagear-6.1.1.jar、startup.bat、startup.sh、shutdown.sh、config/application.properties,外加 lib/ 放外部驱动。

坑来得很快。我按习惯先 java -jar datagear-6.1.1.jar,起不来,报 Could not resolve placeholder 'DG_APP_HOME'。翻到配置的日志段才明白,注释写着"DG_APP_HOME 已在 startup.sh、startup.bat 启动脚本中定义为环境变量"——这 jar 必须由启动脚本拉起,脚本会 set DG_APP_HOME=%~dp0,再用 PropertiesLauncher 带 -Dloader.home 启动。

按标准姿势起来,首次日志写 Started DataGearApplication in 23.14 seconds,因为要初始化 Derby;第二次 10.84 seconds,13 秒内首页 200。访问 http://127.0.0.1:50401,端口在配置第 152 行。停服务用 shutdown.sh,它内部是 kill -9。

结果数据

测试机是 Windows + Temurin 1.8.0_504,单实例空载:包体 66 MB;首启 23.14 秒、二次 10.84 秒;常驻内存 561.8 MB;工作目录首次启动后 20 MB,分出 chartPlugin、dashboard、dataSet、derby、driver、tomcatworkspace 等子目录。

Derby 目录里有份官方自带的 README_DO_NOT_TOUCH_FILES.txt,原话是"编辑、添加、删除这些文件可能导致数据损坏,且无法恢复"。配合 kill -9 停机,隐含风险就摆在那:强杀后 Derby 下次启动要做恢复,恢复失败就得手工救库。早前部署开源报表工具那次是同一个教训——省掉的运维成本,最后都从数据目录里找回来。

6.1.1 只有四条改动:修复看板展示页加载的图表插件信息未同步系统插件状态;插件上传支持多选并显示逐个结果;下载单个插件直接给插件包不再套一层 zip;数据源驱动上传支持多选。三条是批量操作体验,一条是状态同步 bug——典型的重构后遗症补丁。

可复用的部分

最值得抄的是版本号驱动的库升级。启动时比对当前版本号和 Derby 里的版本,不一致就自动执行 DDL,成功后记下新版本号,下次不再跑。对使用者就是换 jar、重启,没有单独的 migrate 命令。

省事,但失败时不好收拾,得知道手工出口。官方 README 写了:升级出问题去 ddl/datagear.sql 找对应版本 SQL 手动执行,再补 UPDATE DATAGEAR_VERSION SET VERSION_VALUE='6.1.1'。不补这句,下次启动还会再跑一遍升级。

第二个是部署形态:server.servlet.context-path 留空是根路径,填 /datagear 就挂二级目录,配 Nginx 反代不用改代码;multipart.maxUploadSize 默认 1 GB,导大 CSV 前不用折腾。

不值得复制的部分

停机脚本用 kill -9。对带内嵌数据库的应用这是最不该省的,SIGKILL 不给进程收尾机会,锁文件和事务日志只能靠下次启动自愈。生产上我宁愿自己写带 kill -15 加等待的脚本。

大版本不做迁移工具,只做自动 DDL。6.0.0 把看板 API 和内置图表插件全重构,6.1.0 又给 API-2.0 的插件 ID 加字符限制(只允许 a-z A-Z 0-9 . _ -)。跨大版本时老看板、自写插件不是"能不能跑",而是"跑到哪一步开始不对"。升级前把自定义插件和看板模板各留一份快照,比看更新日志管用。

561 MB 内存换 70 个图表。空载就这个量级,比 低代码那类 Node 应用重,因为 JVM、Tomcat、Derby 全在一台上面。2 核 4 G 跑得动,但别再并一个 MySQL 还指望宽裕。

安全修补的节奏值得看:6.1.0 有两条直接相关——给 MySQL 的 JDBC 连接加默认防护数据以避免远程代码执行漏洞、默认 SQL 禁用关键字新增 LOAD_FILE;5.5.0 修的是 MySQL 潜在的任意文件读取。JDBC 参数是这类平台最大的攻击面,跨版本别跳。免费与付费的边界也该在选型时一起看。

常见问题

直接 java -jar 报 DG_APP_HOME 找不到?用 startup.bat / startup.sh 启动,或手动把 DG_APP_HOME 指向解压目录。别改配置里的日志路径去绕,那只是把问题挪走。

端口 50401 被占了?改 config/application.properties 的 server.port。改配置比加启动参数稳,参数不会跟着重启脚本走。

能不能放子目录?能,设 server.servlet.context-path=/datagear。反代场景记得前缀透传对齐,否则静态资源 404。

升级后老看板打不开?先确认 DATAGEAR_VERSION 表里的版本号对齐了,再查看板用的 API-1.0 还是 2.0 环境。6.0.0 之后内置图表插件整体重写,老模板的图表元素属性可能要按新 API 调。

GPL-3.0 能商用吗?能,内部部署不涉及分发;对外分发修改版要按 GPL 开源。这跟选开源报表工具的逻辑一致:先看授权,再看功能。

相关阅读

分享到:

本文链接:https://www.biyeyuanma.cn/post/384.html

服务热线

加我微信

加我微信