本文提供了银企平台常见问题的详细分析指导,涵盖网络问题、平台启动问题、web页面业务初始化问题、交易明细查询失败、许可问题、配置连接问题、安装部署问题、其他业务应用报错问题及打补丁等。每类问题均给出了具体的错误现象、排查思路和解决方案,并提供了相关参考链接和脚本操作指南,确保用户能够迅速定位并解决银企平台运行中的问题。
银企平台常见问题分析指导
1、网络问题
1.1读取流失败、前置机未启动等网络问题
参考:https://vip.kingdee.com/article/219112395975578112?productLineId=8
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)
1.3、银企平台启动报错:java.sql.SQLException: 连接串格式错误,或缺少连接信息
原因排查思路:
1、银企数据库是否启动
2、银企数据库帐号用户名密码错误
3、银企数据库ip是否变了 (对比原配置,银企数据库配置文件在/ebservice705/ebservice/server.properties中),该原因可在关闭银企之后,修改server.properties中两处数据库ip保存即可。
3、web页面业务初始化问题
基于银企平台web端与浏览器内核兼容性考虑,所有银企平台web端业务初始化配置问题建议使用谷歌浏览器(Chrome)进行访问。
3.1数据库配置测试连接失败
参考:https://vip.kingdee.com/article/353557392992037632
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变导致特征码变,许可失效
参考:https://vip.kingdee.com/article/191121747020491264
5.2、许可数已经被之前的银行前置机占用完,想清理掉许可占用给新的银行前置机使用
参考:https://vip.kingdee.com/article/191121747020491264
6、银企互联配置连接问题
6.1、EAS/云星空 配置银企互联配置连接测试失败
参考:https://vip.kingdee.com/article/235765032792237056?productLineId=8
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
安装完依赖后,在../ebservice705/apache-tomcat-6.0.20/bin/下执行sh shutdown.sh 再执行 sh startup.sh 重启tomcat服务后问题解决。
4)、linux系统下启动银企平台服务
1、建议使用linux_startup.sh脚本(该脚本是启动后台进程,所以关闭命令行连接也不会杀掉银企服务进程),启动命令即:sh linux_startup.sh
2、回车后会有一行日志打印,不用关心,是正常的,银企平台此时已经在启动过程中
3、如需查看日志观察启动进度可执行:tailf ./logs/ebgateway_debug.log
待银企平台启动完成之后再启动银企客户端
以上问题无法解决,或者之外的问题,可能linux系统版本已经不支持安装程序需要的组件,建议直接获取已安装好的linux系统的银企平台压缩包:https://vip.kingdee.com/article/349202841849997312
8、其他业务应用报错问题
8.1同步付款状态:交易未确认
在银企平台取该笔付款单的付款日志,给提单责任人分析
8.2业务失败,暂时报错信息中包含:’银行返回:XXXXXX’
表示银行返回明确的报错信息,可以取银企平台对应日志找银行确认一下报错原因,然后有需要可找提单责任人处理
9、银企平台打补丁,取日志指导
1、银企7.5版本补丁安装指导见附件
2、如果发现银企平台没有patcher路径(补丁较老,当时版本没有该目录),则需要先单独从银企安装包(下载地址:
)中拷贝一个patcher放到ebservice705路径下,或者直接在附件下载该patcher解压到该路径下,再按照1中指导安装补丁。
正常目录结构是这样:
10、查询余额或者其他操作报错:未经授权的客户端IP
报错:未经授权的客户端IP:192.168. 4.5,禁止访问。请在银企平台web管理页面维护允许访问的IP列表。
解决:银企平台-系统管理-接入方配置-过滤IP列表 中维护该ip,保存即可
11、农行/或其他银行查询交易明细:不是xml格式 :未经授权访问的IP地址[xxx.xxx.xxx.xxx]
原因:农行/或其他银行代理程序配置中访问白名单未配置 银企平台服务器ip,需要将报错提示的ip(银企平台服务器出口ip)维护到白名单配置中。
12、银企平台合作银行,银行网点,功能特性支持情况查询入口
patcher.zip(7.64MB)
银企平台常见问题分析指导.zip(464.18KB)