历史版本16 :JAR包、插件版本不匹配常见问题 返回文档
编辑时间: 内容长度:图片数:目录数: 修改原因:

目录:

1. 概述编辑

1.1 版本

报表服务器版本功能变更
11.0--

1.2 问题描述

JAR 包不匹配主要分为两种：

1）服务器和设计器 JAR 包不匹配

2）插件与服务器或设计器 JAR 包不匹配

本文主要讲解JAR包不匹配的解决方案和影响。

2. 服务器和设计器JAR包不匹配编辑

2.1 问题描述

用户通过设计器远程连接服务器进行远程设计时，设计器和服务器 JAR 包版本要保持一致，否则在设计时，会引发一系列的问题。

FR 11.0 版本的设计器，用户连接远程设计时，当服务器和设计器的 JAR 包不匹配时，设计器右上角出现弹窗，并且设计器“通知中心”按钮显示有新消息状态，如下图所示：

1627539678(1).jpg

当设计器切换工作目录至远程服务器时（直接在菜单里切换，和打开配置工作目录弹窗后点击确定时切换）或设计器连着远程服务器启动后，当服务器和设计器的 JAR 包不匹配时，设计器“通知中心”按钮显示有新消息状态。鼠标点击显示具体异常信息，将出现弹窗，如下图所示：

2021-07-29_14-28-42.png

2.2 解决方案

2.2.1 查看当前版本

保证版本一致，首先客户需知道如何查看设计器和服务器的版本。

1）设计器版本

打开设计器，点击「菜单栏>帮助>关于软件」，可查看到设计器的 JAR 包时间。如下图所示：

1.png

2）服务器版本

打开服务器对应的数据决策系统，点击「管理系统>智能运维>备份还原>更新升级」，可以查看到服务器的 JAR 包时间。如下图所示：

注：这里指服务器对应的数据决策系统，并非本地设计器对应的决策系统。

2.2.2 更新JAR包

若查看后，JAR 包时间不一致，说明设计器和服务器的版本不一致，需更新升级至一致。

1）当设计器可连接至外网时，点击「同步至本地」，将从服务器上获取不一致的内容信息并下载对应jar包和插件并替换本地 JAR 包（只同步启用状态的插件），替换完成后将重启设计器并再次远程到服务器。如下图所示：

若使用如果部分插件未能实现同步，有两种可能原因：

  • 该插件在插件商城由于某些原因已经下架；

  • 该插件是内置插件，无需手动安装，重启设计器即可。

2）当设计器无法连接至外网时，此时需要用户手动替换不一致的内容。由于 JAR 包版本不一致，可联系技术支持获取相关版本的 JAR 包。手动替换 JAR 包的方法参考 小版本升级指南 的 2.1.2 节。若插件不一致，可以拷贝服务器上：%FR_HOME%/webapps/webroot/WEB-INF/plugins下的所有插件，复制到设计器的 %FR_HOME%/webapps/webroot/WEB-INF/plugins 以及 %FR_HOME%/plugins 下，重启设计器即可。

2.3 忽略JAR包不一致可能引发的问题

当版本不一致时，会引发的问题主要表现在以下几个方面。

  • 部分模板挂载在平台上后预览效果和本地预览时有差异。

  • 图表元素显示不全，如图表百分比显示不全、扩展图表不显示等。

  • 模板无法预览，模板预览报错，预览数据集时报错。

  • 切换工作目录失败。

  • 模板内容不全，如模板中数据集无法显示，部分控件无法显示。

  • 数据连接成功，但无法对应库中的表数据。

  • 对模板进行重命名或另存为时，显示没有权限。

以下为一些引发问题的详细介绍。

2.3.1 数据连接成功但无法预览

数据连接成功，但是新建数据集时，看不到视图和表，显示数据库连接失败，如下图所示：

1583204485326555.png

查看日志，发现报错：connection pool shut down，如下图所示：

1583204309403632.png

2.3.2 预览数据集时报错

预览数据集时，报错：java.lang.reflect.UndeclaredThrowableException，如下图所示：

image.png

2.3.3 对模板操作时没有权限

远程设计时，对模板进行重命名或另存为时，显示没有权限，如下图所示：

1583206174831384.png

2.3.4 远程连接时示警

切换工作目录至远程服务器时，跳出警告：远程设计可以连接，但版本不匹配，如下图所示：

1627539678(1).jpg

2.3.5 平台 fetchsize 消失

平台中数据连接高级设置中的「Fetchsize」 设置可能会消失，如下图所示：

3. 插件与JAR包不匹配编辑

每个插件，在插件管理界面、帆软市场插件界面、对应的插件介绍文档中都会注明 JAR 包要求。如下图所示：

当插件版本和 JAR 包版本不匹配时，会影响插件的使用，严重的话会影响整个工程的运行，所以建议用户在使用插件时，要保证插件版本和 JAR 包版本一致。

用户在安装、更新插件时或更新工程后，可能会出现插件版本和 JAR 包版本不匹配的情况，在此种情况下，若无提醒或限制，工程就会有一个隐藏的风险。2021-01-25 及以后的 JAR 包，在插件版本和工程 JAR 包版本不匹配时会自动禁用插件并进行提醒。如下图所示：

在「插件管理」处安装、更新、升级，启用插件或更新工程后启动工程时，系统会自动检测插件版本和 JAR 包是否匹配。当版本匹配时，显示正常，否则弹窗提示和禁用插件。检测点为大版本之间是否匹配，即 10.0 、11.0 是否跨版本；当前工程 JAR 包版本是否适应插件说明中要求的最低 JAR 包版本。

3.1 操作插件时

问题描述：

设计器在线或本地安装、更新、启用插件时，插件版本匹配，可正常操作，显示操作成功的提醒。若是因为插件版本不一致导致的安装失败，则会弹窗提示版本不匹配。如下图所示：

  • 插件版本高于 JAR 包要求的版本时，提示：***插件版本过高，请升级 JAR 包或安装低版本插件。

  • 插件版本低于 JAR 包要求的版本时，提示：***插件版本过低，请安装高版本插件。

解决方案：出现此情况后，用户需检查安装的插件版本和 JAR 包版本，调整为一致后即不会有出错警告。

3.2 启动工程时

问题描述：

更新工程后，工程启动时，当插件版本和 JAR 包要求的版本不匹配时，工程会禁用插件，管理员登录平台，平台会弹窗显示版本不匹配。如下图所示：

注：集群环境下，多个节点都会进行匹配检测。若基准节点先完成启动，提醒时只使用基准节点的检测结果，只进行一次提醒；若基准节点还未完成启动，已有其他节点先完成启动，则会进行多次提醒。

  • 插件版本高于 JAR 包要求的版本时，平台消息通知：插件 xxx 版本过高，已被系统禁用，请升级 JAR 包或安装低版本插件。

  • 插件版本低于 JAR 包要求的版本时，平台消息通知：插件 xxx 版本过低，已被系统禁用，请更新插件。

解决方案：点击消息内容，即可跳转至「插件管理」页面做相应处理，或在平台「系统消息」处，通知内容后有「处理」跳转链接，点击后可直接跳转至「插件管理」页面，管理员可对插件进行删除或更新使得插件可用。如下图所示：

3.3 使用设计器时

问题描述：

若插件版本和本地设计器 JAR 包版本不匹配，打开设计器时，设计器会弹窗提醒：以下插件与 JAR 包版本不匹配已被禁用

弹窗中详细列举了不匹配的插件，点击「立即处理」即可跳转至「插件管理」页面对插件做相应处理。如下图所示：

设计器切换本地其他目录时，也会检测插件和工程 JAR 包是否匹配，不匹配会弹窗提醒。

注：远程设计时，不检测插件版本和工程 JAR 包版本信息，即不匹配时不会弹窗提醒。


解决方案：点击立即处理，对插件进行删除或更新使得插件可用。