【电子回单】回单平台从低版本升级到高版本可能遇到的问题及解决方案

1、使用http://IP:8089打开回单登录页面时，提示请求IP不存在IP白名单中

    具体提示如下：

请求ip：xxx.xxx.xxx.xxx不存在IP白名单中，请使用127.0.0.1:8089登录后在系统配置添加白名单IP

解决方案：

    如下图所示，使用http://127.0.0.1:8089登录回单平台后，在配置项  - 系统配置页面“回单程序访问白名单”中添加白名单，多个IP中间以英文分号隔开。注意：不要删除127.0.0.1这个默认值。

    对于使用linux操作系统的服务器，基本都是无图形界面的，无法通过本地浏览器访问回单程序。这种情况下可以在回单程序的配置文件中（config文件夹内的application.yml文件）的末尾添加whiteIps字段，后面追加需要访问回单程序的IP地址、代理地址等，中间用英文分号分隔。如图所示：（箭头处有空格，符号均为英文符号）

whiteIps: 127.0.0.1;

2、使用旧版本设置的密码无法登录回单平台

解决方案：

    之前的旧密码设置的过于简单，例如123456这种，升级到最新版后登录时系统检测到密码不符合要求，所以无法登录系统。需要重置密码为初始密码，操作步骤如下：

1）连上回单库（双击回单安装目录下的数据库配置程序start_Config.bat可以查看回单库的信息）后，修改回单数据库表t_ebg_user字段user_password 值为 $apr1$Kingdee$5Ok1ttuLwq48MpweypqN00   ，对应密码为kingdee@2020

2）然后登录回单系统，输入用户名、密码（kingdee@2020）之后，首次登录会弹出用户密码修改窗口，需要输入原密码（kingdee@2020）、新密码、确认密码后点【提交】按钮，然后系统会跳转到登录页面，请使用新密码进行登录。

新密码要求：

1）至少需要包含数字、字母或字符中的三种

2）密码长度为8 - 18个数字或字符

3、登录后，“系统配置”页面和“银行配置”页面缺少配置项

    例如，配置项 - 系统配置页面缺少新版本增加的两个配置项：回单程序访问白名单、是否传输sftp账号密码给业务端。

解决方案：

    版本的更新涉及配置项的增加，需要重新初始化元数据。步骤：【回单】-【配置项】-【系统配置】页面最下方“重新初始化元数据”，点【更新】按钮。

4、系统配置页面 - 更新元数据报错

   如下图所示，点【更新】按钮报错了，提示：请求异常：could not execute statement

解决方案：

    以oralce回单库为例，查看回单日志，可以看到如下报错：

Caused by: java.sql.SQLException: ORA-12899: value too large for column "SYSTEM"."T_EBG_CONFIG_META_DATA"."CONFIG_DESC" (actual: 882, maximum: 800)

    需要将回单库的表T_EBG_CONFIG_META_DATA的CONFIG_DESC字段的长度改大，例如改成1000。然后再去执行更新元数据操作。

    如果是sqlserver库，回单日志类似下面这样：

2023-11-24 16:11:20.435  INFO [,,] 1540 --- [qtp1014982340-17] c.k.b.r.conf.EBConfigStorage            : 元数据重新设置成功！

2023-11-24 16:11:20.498  WARN [,,] 1540 --- [qtp1014982340-17] o.h.engine.jdbc.spi.SqlExceptionHelper  : SQL Error: 8152, SQLState: 22001

2023-11-24 16:11:20.498 ERROR [,,] 1540 --- [qtp1014982340-17] o.h.engine.jdbc.spi.SqlExceptionHelper  : 将截断字符串或二进制数据。

2023-11-24 16:11:20.498  INFO [,,] 1540 --- [qtp1014982340-17] o.h.e.j.b.internal.AbstractBatchImpl    : HHH000010: On release of batch it still contained JDBC statements

2023-11-24 16:11:20.513 ERROR [,,] 1540 --- [qtp1014982340-17] c.k.b.r.c.ExceptionHandlerAdvice        : 未知异常

org.springframework.dao.DataIntegrityViolationException: could not execute statement; SQL [n/a]; nested exception is org.hibernate.exception.DataException: could not execute statement

5、升级后登录回单平台，发现之前的配置全都不见了，急急急

    遇到过几次客户反馈此问题：升级回单平台到最新版本，登陆进去后发现界面上的配置都没有了。连上回单库看，回单库的表中例如t_ebg_config（保存界面上的配置信息）、t_receipt_detail（保存回单信息）也都没有数据了。

解决方案：

    找到旧的回单安装路径，启动数据库配置程序start_Config.bat，在对比升级后的回单系统的数据库信息，发现二者完全不一样。现场在安装最新版的回单系统后，没有连到旧的那个回单库，而是连了一个新的库，这个新的库里是没有数据或者缺失了数据的。所以，需要参照旧的回单系统的数据库配置信息，去修改新的回单系统的数据库配置信息，然后重启回单服务再登录进去看，配置信息及回单信息都还在。

6、升级后，银企平台查询电子回单提示读取流失败

星空下载电子回单报错，提示缺少银企文件服务器信息。或者提示银企平台返回：读取流失败。

EAS下载回单文件报错，提示【连接回单FTP服务器失败】下载PDF文件：IP:xxx.xxx.xxx.XXX 端口:-1 用户名:null ，请现场根据 下载回单文件的IP、端口、用户名 和 密码，检查FTP服务器连接是否正常！

解决方案：

    基于安全考虑，最新版本的回单系统增加了下面两个配置项。需要您配置一下：

1）回单程序访问白名单

配置说明：填入允许访问电子回单程序的IP地址，中间以英文分号隔开。银企平台、星空以及EAS访问电子回单程序时需要配置白名单IP，白名单以外的IP无法访问电子回单程序。默认值(127.0.0.1)

2）是否传输sftp账号密码给业务端 

配置说明：启用此功能，会在业务端查询回单信息时将sftp账号密码作为 参数传给业务端，如果系统部署在公网，存在安全问题。默认值(否)    

详细可参考：https://vip.kingdee.com/article/455664570829516288?productLineId=8&isKnowledge=2

7、升级后，星空或eas中，交易明细和电子回单未匹配

解决方案：

    如果是升级回单版本后才出现的问题，那未匹配的原因往往是回单码不一致。升级回单系统后，部分银行的电子回单的匹配码规则发生了变化，例如可能在回单码中拼接了金额字段。而银企补丁较旧的话，交易明细的回单码的拼接规则还是旧的，所以交易明细和电子回单无法匹配。

    因此，更新回单版本后，还需要更新银企平台的补丁，目的是更新交易明细的匹配码规则。更新银企补丁之后，在银企平台 - 交易明细查询 页面，勾选“立刻获取银行所有明细”之后，再选择银行账号、日期等进行查询，则可更新交易明细的回单码；然后再到EAS联机查询交易明细（或星空中重新接收银行交易流水），则可更新业务系统中交易明细的回单码，然后再对交易明细和电子回单按回单