反馈已提交

网络繁忙

JAR包不匹配常见问题

  • 文档创建者:Carly
  • 编辑次数:18次
  • 最近更新:Lily.Wang 于 2022-11-02
  • 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 包版本信息,即不匹配时不会弹窗提醒。


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

    附件列表


    主题: 安装与升级
    • 有帮助
    • 没帮助
    • 只是浏览

    售前咨询电话

    400-811-8890转1

    在线技术支持

    请前往「服务平台」,选择「在线支持」

    热线电话:400-811-8890转2

    总裁办24H投诉

    热线电话:173-1278-1526

    文 档反 馈

    鼠标选中内容,快速反馈问题

    鼠标选中存在疑惑的内容,即可快速反馈问题,我们将会跟进处理。

    不再提示

    10s后关闭