本文介绍了金蝶银企互联平台在使用过程中可能遇到的网络问题、启动问题、web页面业务初始化问题、交易明细查询失败、许可问题、配置连接问题及安装部署问题等,并提供了详细的排查和解决思路,包括确保前置机启动、检查IP端口配置、处理异常状态码、日志报错等。此外,还针对特定场景如银行返回null、同步付款状态未确认等问题给出了处理建议,并提醒用户注意浏览器兼容性、服务器迁移导致的许可问题以及安装部署时的依赖问题。
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
作者:汪伟康
来源:金蝶云社区
推荐阅读