银企平台常见问题分析指导

1、网络问题

1.1读取流失败、前置机未启动等网络问题

排查思路：

1、确保银行前置机成功启动

2、检查银企前置机配置的IP和端口是不是对应的银行前置机服务器ip，有的客户配成了银行IP是错的

3、网络问题，telnet 前置机端口，前置机反过来也要能telnet银企5289端口 ，最好关闭防火墙和杀毒软件再试

4、有些银行前置机有证书，在银企的前置机配置那里需要配上证书ID

5、以上都确认没问题，需要找银行排查前置机相关配置

1.2银行返回异常状态码（如：4xx,5xx）

找银行排查返回错误码4XX或5XX的原因（400，403，500，502等）

1.3银行返回null

找银行排查响应返回空的原因

1.4日志报错：签名失败

一般为银行提供给前置机的证书问题，找银行排查原因

2、银企平台启动问题

1.1启动报可能内存不足

解决思路：将当前dos命令窗口关闭，按提示用后缀带_1g那个脚本启动

1.2 启动银企平台报表字段不存在之类的错误

原因：可能是执行补丁安装脚本提示数据库连接异常，没有成功执行数据库升级脚本。

解决思路：将银企安装路径下的补丁安装脚本再次执行一次，执行成功之后，再执行银企启动脚本。

以上操作如果还是有相同报错，尝试执行数据库初始化脚本。

注：补丁安装脚本(..\ebservice705\patcher\windows_startup_in_console)

注：数据库初始化脚本(..\ebservice705\ebservice\windows_ebg_db_init)

3、web页面业务初始化问题

基于银企平台web端与浏览器内核兼容性考虑，所有银企平台web端业务初始化配置问题建议使用谷歌浏览器(Chrome)进行访问。

3.1数据库配置测试连接失败

分析思路: 如果有web前端页面调试经验，可以按F12，通过选择network来捕捉请求和响应具体信息分析。

若无则按以下常见思路排查：

1)、检查数据库服务器的ip、端口，在银企服务器是否可以通过telnet ip port 命令测通

2)、数据库名称，账户密码是否正确，使用其他工具是否连接上该数据库。

数据库密码是否有特殊字符（如：%，&，#，?，/，+，=，空格等），由于目前http请求会将一些特殊字符进行转码，造成银企平台最后进行测试连接失败。建议修改密码不要包含以上特殊字符再去尝试初始化配置。

3)、以上操作都没有解决问题，建议重启银企平台。如果还未解决，请联系提单责任人处理。

3.2最后一步初始化直接失败

1)、若有明显的报错信息：如 ...\server.properties拒绝访问。

建议：先备份该文件到其他路径下，然后删掉该文件，新建一个文件名和后缀相同的空文件，再重试业务初始化配置。

2)、若不会以上操作或者其他问题，找提单责任人分析。

3.3业务初始化页面访问返回404

1、若银企客户端tomcat成功启动未报错，127.0.0.1:5389访问报404 ->建议：换谷歌浏览器(Chrome)重试

2、若银企客户端tomcat启动失败，可尝试先执行shutdown.bat再执行startup.bat进行重启

3、如果还是启动失败，可联系银企问题责任人处理

4、交易明细查询失败或者代发失败

4.1报错信息：‘向金蝶前置机代理程序上传文件发生异常................’或者‘生成支付请求文件上传文件：********************失败’

原因:没有安装或者正常启动代理程序。

需要了解：

1)、建行企业现金直连： 所有业务都需要走代理程序

2)、农行（公网版和专线版）：代发和查询交易明细需要走代理程序

3)、其他银行（浙商银行，南京银行，光大银行，建行外联版）：只有代发要走代理程序

若代理程序正常启动，请检查银企平台与代理程序的网络，并按照代理程序安装配置指导文档排查相关配置。

若其他报错，请取银企查询交易明细明细日志联系提单责任人分析

5、许可问题

5.1、服务器迁移，ip变导致特征码变，许可失效

建议：特征码变了，在金蝶社区提交重新注册申请，会有客服同事对应处理。如有其他不清楚的，可直接联系尤福欢确认

5.2、许可数已经被之前的银行前置机占用完，想清理掉许可占用给新的银行前置机使用

建议：

1）、先把要被换掉的银行之前的账户删掉

2）、打最新补丁

3）、清理占用许可：https://vip.kingdee.com/school/6235

4）、重启银企服务

5）、这个时候你要用到哪个银行就用哪个银行去查询余额（抢占许可，注意不要再用之前那个银行去做业务了，不然又会占用许可）

6、银企互联配置连接问题

6.1、EAS/云星空 配置银企互联配置连接测试失败

排查思路：1)、查看银企平台是否正常启动，telnet ip port是否通

2)、银企平台-【系统配置】-【接入方配置】是否有将eas或者云星空业务系统的服务器ip添加到白名单中

3)、若是云星空，8.2以上银企互联有安全服务配置开关，没有特殊需求，不要勾选该选项。

4)、其他问题联系提单责任人处理

7、银企安装部署问题

7.1、windows系统建议2008R2，或者2012

7.2、安装部署文档，用户手册有需要可找提单责任人提供

7.3、linux环境下安装银企，由于安装银企需要依赖一些组件，因此需要保证与外网网络畅通以下载相关组件。

1)、linux安装报错/lib/libc.so.6 No such file

执行命令：

yum -y install glibc.i686

2)、linux安装报错提示libXext.so.6: cannot open shared object file

这是由于64位的linux缺少一些银企平台需要的lib，

执行以下命令即可：

  yum install libXi.i686

  yum install libXtst.i686

  yum install libXrender.i686

3)、linux环境下安装的银企平台705版本，安装完现在是第一次启动。银企服务已经启动，但银企平台客户端无法打开默认登录地址

执行以下命令：

yum install libXtst.i686 -y

yum install libXtst-devel.i686 -y

yum insall libXtst-devel.x86_64 -y

安装完依赖后，执行sh shutdown.sh 再执行 sh startup.sh 重启tomcat服务后问题解决。

8、其他业务应用报错问题

8.1同步付款状态：交易未确认

在银企平台取该笔付款单的付款日志，给提单责任人分析

8.2业务失败，暂时报错信息中包含：’银行返回：XXXXXX’

表示银行返回明确的报错信息，可以取银企平台对应日志找银行确认一下报错原因，然后有需要可找提单责任人处理

业务应用错误问题较多，一些常见业务应用报错后续单独更新一篇FAQ

9、打补丁，取日志指导

见附件

银企日志收集方法.docx

银企补丁更新方法-new.docx