管理系统问题排查

报错 535 Error: authentication failed

问题描述：

发送邮件失败，报错：535 Error: authentication failed

解决方案：

密码应该填写授权码，而不是邮箱密码。详情请参见：邮箱

未加入java受信任列表导致测试邮件发送失败

问题描述：

内网服务器上，使用 foxmail 发送 SSL 加密过的邮件没问题，使用 finereport 有问题。改成不加密25端口是可以发送出来的。

报错 "Could not connect to SMTP host: SMTP.fanruan.cn, port: 465, response: -1" 

原因分析：

用户在内网自行搭建的邮箱服务器需要加入java证书信任列表，对于没有加入到java受信任列表中的证书是无法发送邮件的。其他的一些客户端例如 firefox 有自己的证书信任体系就可以正常发送。

解决方案：

将证书导入到 java 证书受信任列表即可。

反垃圾机制

日志报错：com.sun.mail.smtp.SMTPSendFailedException: 554 DT:SPM 163

原因分析：这个报错是 163 邮箱服务器的反垃圾机制，把标题为test的测试邮件当作垃圾邮件了，导致发送失败。

解决方案：测试邮件不要写测试、test之类的字眼，可以发送成功，说明本身配置没有问题，只是服务器自身限制。

获取验证码出错

若在一分钟之内频繁发送邮件，会报错「获取验证码出错」，如下图所示：

一分钟之后继续发送即可。

使用465端口报错

问题描述：

报错：Could not connect to SMTP host: SMTP.exmail.qq.com, port: 465, response: -1'

原因分析：

465端口是为SMTPS（SMTP-over-SSL）协议服务开放的，是基于SSL安全协议之上的变种协议。

而帆软邮箱需要的是开启SSL协议

解决方案：

改用25端口

名称不能重复

问题描述：

开放平台新建应用时报错：名称不能重复。如下图所示：

原因分析：

查看 fanruan.log，发现是 fr_open_app 表中 secret 字段长度较小。

解决方案：

增加 secret 字段长度。

FineDB 内置：

ALTER TABLE "PUBLIC"."FR_OPEN_APP"  ALTER secret  VARCHAR(1000);

FineDB 迁移到 MySQL 中：

ALTER TABLE PUBLIC.FR_OPEN_APP   MODIFY COLUNM   secret  VARCHAR(1000);

导入定时任务时全选任务导入异常

问题描述：

4.0.28 版本，资源迁移导入定时任务时，全选任务列表，提示：0个成功，0个失败；如果选择部分定时任务导入，可成功导入。

原因分析：

待导入的定时任务中，缺少部分子任务。

解决方案：

待导入任务中包含所有子任务。

xxx外接数据库插件已过期，当前操作不生效

问题描述：

在用户管理中进行以下操作时，操作失败：

• 「添加/编辑/删除/禁用/导入」用户

• 「添加/编辑/删除」部门

• 「添加/编辑/删除」职务

并弹窗提示： xxx外接数据库插件已过期，当前操作不生效，该功能目前受到影响，请及时注册

如下图所示：

原因分析：

工程使用了信创版本外接 finedb 数据库，该类型数据库的功能点授权已过期，因此影响到了用户管理功能，无法正常使用。

解决方案：

请联系帆软销售，续购/增购该类型数据库相关的使用授权。

wrong name: com/fr/decision/privilege/encrpt/Base64PasswordValidator

问题描述：

设置自定义加密方式后，同步用户失败，报错：NoClassDefFoundError: com/fr/decision/privilege/Base64PasswordValidator (wrong name: com/fr/decision/privilege/encrpt/Base64PasswordValidator)

原因分析：

自定义加密类 class 文件保存路径错误。

解决方案：

报错信息中，wrongname：后的路径为正确路径，将 class 文件移动至正确路径下，重新设置加密方式即可。

上次登录信息显示不准确

问题描述：

登录 FineDataLink 数据平台时，上次登录信息中信息不准确。

原因分析：

登录信息的获取是在登录页获取的，若用户跳过 登录页 直接进入 FineDataLink 数据平台，本次的登录信息将不会记入上次登录信息。

例如：在登录页勾选「保持登录状态」，进入 FineDataLink 数据平台（已开启「上次登录信息提示」按钮），上次登录信息显示为时间 1 ，彻底关闭浏览器；

不经过登录页，再次进入 FineDataLink 数据平台，此时登录时间为时间 2 ，但上次登录信息仍然为时间 1 。

不显示上次登录信息

问题描述：

开启了「上次登录信息提示」按钮，但是登录时不显示上次登录信息。

原因分析：

登录信息中的IP和城市，是通过帆软云中心https://cloud.fanruan.com/api/query/ip?timeout=10000获取的。

若服务器无法连通该地址，将无法成功获取上次登录信息。但是对日志记录没有影响。

所有用户无法登录平台

问题描述：

用户工程使用了 Nginx 代理，并设置了登录锁定中的「IP锁定」，当密码错误次数超出限定次数时，登录锁定，所有用户都无法登录 FineDataLink 。

原因分析：

在有代理的情况下，用户的登录请求是先到反向代理，反向代理再转发到 FineDataLink 工程。

所以工程获取的 IP 地址为 Nginx 所在服务器的 IP 地址，锁定的 IP 地址也为 Nginx 所在服务器的 IP 地址，导致后续所有用户无法登录。

解决方案：

在 Nginx 中加入请求头，用于携带用户的真实 IP ，使得 FineDataLink 工程能够获取用户的真实 IP 。

1）单层 Nginx 代理

编辑 nginx.conf 文件，在 location 模块下增加以下配置，如下图所示：

proxy_set_header X-Forwarded-For $remote_addr;

2）多层 Nginx 代理

在直接对外的 Nginx 代理服务器上，编辑 nginx.conf 文件，在 location 模块下增加以下配置，如下图所示：

proxy_set_header X-Forwarded-For $remote_addr;

在内层的 Nginx 代理服务器上，编辑 nginx.conf 文件，在 location 模块下增加以下配置，如下图所示：

proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;

检测到云端运维资源长时间未更新，可前往云端运维更新资源

问题描述

当云端运维插件版本日期与当前日期相差大于 2 个月，系统将通过云端运维页面和平台消息提醒管理员。如下图所示：

提示：检测到云端运维资源长时间未更新，可前往云端运维更新资源。

解决方法

在帆软市场下载 云端运维安装包 ，参考 插件管理 安装即可正常使用。

tomcat 闪退，并且无 tomcat 进程出现

问题描述：

使用健康巡检的「快速修复」功能，修改了tomcat内存后，使用./startup.sh命令启动工程，tomcat 闪退，并且无 tomcat 进程出现。

原因分析：

系统内存不足。

解决方案：

删除%TOMCAT_HOME%/bin下的setenv.sh文件，该文件为快速修复时生成的配置文件。

菜单图标丢失

问题描述：

管理员进入 FineDataLink ，系统页面的菜单图标丢失。

原因分析：

用户为 HTTPS 环境， HTTPS 下 IE 浏览器加载机制的问题。

解决方案：

管理员进入 FineDataLink ，点击「管理系统>安全管理>高级设置」，关闭「浏览器缓存禁用」按钮。如下图所示：

if you are using the mysql client program,it's default max_allowed_packet variable is 16MB.To set a large value

问题描述：

对 MySQL 数据库执行网络组件检测时，报错：

if you are using the mysql client program,it's default max_allowed_packet variable is 16MB.To set a large value

此时修改并将配置项 max_allowed_packet 调大即可，修改方法您可查阅相关资料。

原因分析：

检测操作的数据量传输可能会超出 MySQL 的限制，

MySQL 数据库中「max_allowed_packet」值设置过小，导致数据传输量超出限制。

解决方案：

方案一：

MySQL 安装目录下的「my.ini」文件中的[mysqld] 字段中的「max_allowed_packet = XM」修改为500M ，重启 MySQL 即可。

方案二：

1）使用「set global max_allowed_packet = 524288000;」 语句将「max_allowed_packet」的值设置为 500 M。

2）使用「show VARIABLES like '%max_allowed_packet%';」 语句查看是否修改成功。

使用 drop 语句报错

问题描述：

4.0.28 及之后版本，SQL 语句中使用了 drop 语句，报错：无法使用关键字，且无法关闭sql防注入功能

原因分析：

「数据同步」和「数据转换」节点中加入了 sql 防注入校验。

解决方案：

可在「SQL脚本」中使用 drop 语句，数据同步、参数赋值、数据转换中不支持 drop 语句。

fine_conf_entity 表中数据长度过长

问题描述：

备份失败，报错「java.sql.SQLDataException: data exception: string data, right truncation;  table: FINE_CONF_ENTITY column: VALUE」

原因分析：

fine_conf_entity 表中存在数据长度超长，导致备份失败。

解决方案：

方案一：将超长的数据字段筛选出来删掉 。

方案二：仅支持 mysql 类型的外接数据库使用该方案。

超级管理员可通过「fine_conf_entity可视化配置」，修改BackupConfig.customValueLength参数值，来调整最大长度限制，重启服务器后设置生效。如下表所示：

Fail to write entity GlobalParamEntity

问题描述：

平台配置备份失败，报错Fail to write entity GlobalParamEntity

原因分析：

「参数赋值」节点的调试值长度限制为 255，用户调试值超过 255 没法存到数据库里，就手动将调试值长度限制改为 1000，导致备份 FineDB 时把外置库备份为内置库报错。