anyoffice 隧道排错指南

anyoffice 隧道排错指南

通常

移动端在登录时,初始化esdk后,报错”服务器异常,请稍后在试”,然而却是一次都登录不上.

这种问题,属于http访问不通,观察客户端的console报错日志.如果返回500错误,服务器也会有错误日志.
这时,可以通过esdk的log查看是什么原因,也可以通过服务器的监控日志查看报错信息.

问题域:
参与对象:移动端,anyoffice,服务端,网络问题.

作为测试人员,要对以下情况进行区分:

1.不同机型,android,ios,华为,三星.

2.不同网络,例如4G/wifi(网络请求没有经过外部防火墙DMZ)

服务端的人员
要排查错误,可以通过绕开anyofficesdk,使用postman模拟移动端提交post请求,抓包查看状态码.如post请求到达 DMZ区后有没有转发到内网vv服务器.内网vv服务器有没有收到请求.

anyoffice人员
可以通过调试包sdk集成到customer app,抓包查看.

不通常

因为业务升级,但是又不能排除是否是anyoffice sdk引起,使用排除法要排除anyoffice,就要使得app脱离esdk的隧道全局Hook,[esdk 全局hook之后,还提供了白名单(白名单列表服务不会通过anyoffice的隧道,直接访问服务器地址).]就需要在调试期间让app不走隧道,简单的做法就是在AnyofficeAuth.java里,将isUseVPN=false;该方法是通过所有该类方法被调用前都判断isUseVPN是否为true,否则一律直接返回,这样anyoffice的所有功能全部不会调.

如果想在测试环境下,任意的设置anyoffice开关,可以在kdweiboConfiguration.java类里面,添加开启和关闭anyoffice vpn设置的方法,这样在登录首页,用户就可以在隐藏的右上角双击菜单上选择开发环境(建议设置为false关闭anyoffice),测试环境(建议设置为true开启anyoffice),正式环境(建议设置为true开启anyoffice).

anyoffice的注意事项

1.anyoffice的使用指南要认真看,一字不落的看.

2.别在application类的oncreate方法初始化esdk,这样会初始化两次,而实际上,esdk只允许初始化一次,曾经就因为这样干导致隧道不停的在重建.

3.隧道建立需要认证成功,在网络不稳定如电梯间或4G信号不稳定的时候,隧道会断开.隧道变更回调方法会启用,这里要做好通知和掉线处理.在首页应该有提示隧道中断,允许用户下拉重新进行认证,虽然anyoffice文档中说明只要认证成功,隧道会自动重建.

4.隧道如果没有建立成功,就发起业务网络请求,会导致请求失败,对于IM这种及时性要求,我们用了白名单(对于IM服务器访问不受限制).