1. 概述
1.1 版本
| 报表服务器版本 |
|---|
| 11.0 |
1.2 问题描述
插件安装和管理过程中，可能会出现一些问题。
本文将提供常见插件安装/维护问题的解决方案。
2. 插件管理界面异常
2.1 插件商店有新版本，是否更新
问题描述：
管理员登录数据决策系统，点击「管理系统>插件管理」，插件管理界面有时会弹窗提示：「插件商店有新版本，是否更新？」，如下图所示：
原因分析&解决方法：
此时更新的是帆软商城中插件，不会更新工程中已安装的插件，点击「确定」按钮即可。
2.2 插件管理界面空白
问题描述：
管理员登录数据决策系统，点击「管理系统>插件管理」，提示：「您还没有插件商店的资源，是否下载？」
点击「确定」按钮后，「插件管理」界面依然空白。如下图所示：
原因分析&解决方法：
1）设计器和服务器 JAR 包不一致，保持一致之后即可恢复正常。
2）用户在本地或远程工作目录中，勾选了「使用新插件管理器」按钮。
注：「使用新插件管理器」按钮具体介绍可参考 选项 中的 3.4 节内容。
外网用户：外网用户在插件管理页面的弹窗上，点击确定按钮后，清理浏览器缓存，重新进入数据决策系统即可。
内网用户：请联系技术支持获取 upm 文件夹，将 upm 文件夹放到%HOME%\webapps\webroot\WEB-INF\assets文件夹下。
注：付费用户请联系技术支持。技术支持联系方式：
在线支持：前往「服务」，选择「在线支持」
电话：400-811-8890
2.3 应用商城界面空白/帆软通行证无法登录
问题描述：
1）以管理员身份进入数据决策系统后，点击「管理系统>插件管理」，应用商城页面空白，如下图所示：
2）登录帆软通行证时，提示「未知错误」。如下图所示：
3）设计器中点击右上角登录，提示「网络连接失败」。如下图所示：
排查步骤一：查看外网地址是否开放
原因分析：服务器没有连外网。
解决方法：根据需要开放的外网地址，开放网络即可。详情请参见：FineReport外网地址
排查步骤二：查看「连接网址管理中心」是否开启
原因分析：服务器可以通外网，在平台系统管理节点的「常规」 Tab 页中关闭了连接网址管理中心按钮，插件引擎模块无法使用。
解决方法：以管理员身份进入数据决策系统，点击「管理系统>系统管理>常规」，开启「连接网址管理中心按钮」，点击保存。如下图所示：
注1：远程环境中若关闭连接网址管理中心按钮，也将出现本节「问题描述」中的现象。
注2：连接网址管理中心按钮的介绍请参见：常规 中的 2.2 节内容。
排查步骤三：查看服务器系统时间与北京时间是否一致
原因分析：插件商城网址用的是北京时间，从插件管理登录的时候需要验证token。token是按照用户的系统时间生成的，登录时远程服务器会校验传过来的这个token是否正确，如果时间不对，就无法登录。
解决方法：服务器系统时间与北京时间保持一致
3. 插件在线安装失败
3.1 报错：connection time out
问题描述：
插件在线安装失败，报错 connection time out
原因分析：
当前工程无法成功连接在线插件商城。
解决方法：
根据需要开放的外网地址，开放网络即可。详情请参见：FineReport外网地址
3.2 插件在线安装/更新无进度
问题描述：
在数据决策系统安装/更新插件时卡住，不显示进度条，不显示「安装完成」。刷新页面后，发现插件已经安装/更新好了。
原因分析：
WebSocket端口被占用了，无法主动给浏览器推送消息。
解决方法：
开放 WebSocket 端口，详情请参见：Websocket 连接失败 。
4. 插件本地安装失败
4.1 插件本地安装/更新无进度
问题描述：
从本地选择插件安装包，安装插件后，无安装进度，不显示「插件安装成功」。
原因分析&解决方法：
1）插件安装包过大，安装较缓慢。请耐心等待即可。
2）工程环境无法连接安装包所在的位置。例如无法连接外网等。开放网络路径即可。
3）插件安装目录无权限，请确保用户有以下目录的读写执行的权限
%FR_HOME%\plugins
%FR_HOME%\webapps\webroot\WEB-INF\plugins
4.2 文件上传失败/未找到安装包 Request Entity Too Large
问题描述：
从本地安装插件，提示「文件上传失败」/「未找到安装包」，F12查看日志发现报错「413 Request Entity Too Large」。
原因分析：
上传的插件安装包过大，一般Linux默认上传文件的上限大小为1M。
解决方法：
1）不使用本地安装方法，改用「手动安装」方法，详情请参见：服务器插件管理
2）修改Linux的配置文件
找到 nginx.conf 文件，更改body size
更改后 nginx -s reload 重新加载一下，如果命令加载不成功，则需要重启 Linux 服务器进行加载
5. 插件安装后使用失败
问题描述：
数据决策系统（服务器端）安装插件后，设计器端远程连接该工程，无法使用插件功能。
排查步骤一：检查本地设计器和远程服务器是否都安装了插件
对于设计器和服务器都会用到的插件，要求服务器端和设计器端都要安装：
若服务器端安装了插件，设计器端没有安装插件，则插件不会生效，需要切换到本地进行插件安装。
若服务器端和设计器端均安装了插件，服务器端的插件下载、删除、禁用不会立即生效，需要等几分钟才会生效。
若服务器端和设计器端均安装了插件，设计器切换到本地，禁用该插件，不影响远程连接时服务器端的插件使用。
注：设计器插件有两个路径，两个路径都需要有插件包，否则安装无效：
%FR_HOME%\plugins
%FR_HOME%\webapps\webroot\WEB-INF\plugins
若%FR_HOME%\plugins目录下没有插件/插件不生效，一般会报错「Plugin not installed at designer」，请卸载重装。
排查步骤二：检查本地设计器和远程服务器插件版本是否一致
原因分析：若设计器端和服务器端均安装了插件，但是插件版本不一致，可能导致插件功能失效。
解决方法：将本地设计器和远程服务器插件版本升级到一致。
排查步骤三：检查插件版本是否最新
如果插件版本不是最新版，可将本地设计器和远程服务器插件版本升级到最新，再进行测试。
注：大部分移动端插件和HTML5移动端展现插件的版本之间有依赖关系。
请参照具体的插件帮助文档，确保所使用的移动端功能插件和HTML5移动端展现插件之间的版本互相支持。
排查步骤四：检查本地设计器和远程服务器JAR包版本是否一致
原因分析：如果本地设计器和远程服务器JAR包版本不一致，会带来很多问题，也有可能会导致插件失效。
解决方法：将本地设计器和远程服务器JAR包版本升级到一致，升级方式请参见：小版本升级指南
排查步骤五：检查远程服务器工程中是否存在冗余JAR包
原因分析：一般来说，远程服务器工程%FR_Home%/webapps/webroot/WEB-INF/lib目录下不应该存在fine-report-designer-11.0.jar文件。若远程工程没有删除这个JAR包，会导致工程报错以及插件不生效。
解决方法：请备份JAR包后，将远程服务器工程%FR_Home%/webapps/webroot/WEB-INF/lib目录下的fine-report-designer-11.0.jar文件删除，重启报表工程后再次尝试。
排查步骤六：检查是否存在历史版本插件包
原因分析：若工程下同时存在多个版本的插件包，可能会导致插件不生效。
解决方法：
1）检查设计器下两个路径内的插件包，删除冗余插件包。
%FR_HOME%\plugins
%FR_HOME%\webapps\webroot\WEB-INF\plugins
2）检查服务器工程下的插件包，删除冗余插件包。
%Tomcat_HOME%\webapps\webroot\WEB-INF\plugins
排查步骤七：检查文件夹权限
服务器工程的启动用户，需要对WEB-INF文件及其子文件有读写执行的权限。
6. 插件过期
问题描述：
提示XXX插件过期，请前往帆软应用中心进行购买。
原因分析：
用户所使用的报表工程是已注册的，对未购买授权的付费插件，用户可免费试用90天，90天后需要购买授权方可使用。
FineReport工程未注册时，插件可免费使用，无需进行授权。
FineReport工程注册后，免费插件可正常使用，无需进行授权。
FineReport工程注册后，购买了授权的付费插件，用户可正常使用。
FineReport工程注册后，未购买授权的付费插件，用户可免费试用90天，90天后需要购买授权方可使用。
解决方法：
购买插件授权并添加到报表工程中即可，详情请参见：插件注册
