每日一技|巧用 Telnet 调试 Dubbo 服务

>>强大,10k+点赞的 SpringBoot 后台管理系统竟然出了详细教程!

点击蓝色“程序通事”关注我哟

加个“星标”,不迷路哦

0x00. 前言

想象这样一个场景,线上某个服务突发异常,导致上游服务调用异常,数据处于中间状态。服务恢复之后,我们需要修复这笔数据至正常状态,怎么办?

如果仅是简单的服务,涉及少量数据变更,我们可以直接使用 SQL,变更数据状态。但是有些情况下,服务需要联动调用其他系统,变更其他系统数据。这种情况下,变更数据非常麻烦,需要与其他系统开发沟通,整理数据,一起变更。如果涉及还涉及外部系统,数据变更几乎玩不下去了。

如果服务接口能重试,重新调用,那么数据变更就交给服务自动去调用即可。这个过程我们需要组装参数,然后调用服务接口。如果你的服务采用 Http 接口,可以使用 Curl 等命令重试。如果你的服务使用 Dubbo ,这就需要使用到 Telnet 命令。

0x01. telnet 进入 Dubbo 调试

通过以下指令,连接 Dubbo 服务。

1telnet  IP PORT
2#例如:
3telnet localhost 20880

Dubbo 版本需要大于 2.0.5,远程调用需要注意网络是否可用

连上之后,按下回车键将会进入以下页面:

每日一技|巧用  Telnet 调试 Dubbo 服务

这个界面与 Shell 类似,需要我们输入相关命令。例如:

每日一技|巧用  Telnet 调试 Dubbo 服务

命令参考手册:http://dubbo.apache.org/zh-cn/docs/user/references/telnet.html。

0x02. invoke 执行 Dubbo 方法

这里我们重点介绍 invoke 命令,该命令可以用来执行 Dubbo 服务,调用方式如下:

1# 需要提前调用 cd XxxService,使这个服务成为缺省服务
2invoke xxxMethod(1234, "abcd", {"prop" : "value"})
3# 调用该服务的方法
4invoke XxxService.xxxMethod(1234, "abcd", {"prop" : "value"})
5# 调用全路径服务的方法,推荐使用这种方式,精确执行服务方法。
6invoke com.xxx.XxxService.xxxMethod(1234, "abcd", {"prop" : "value"})

运行结果如下:

每日一技|巧用  Telnet 调试 Dubbo 服务

槽点:mac 平台 iterm2 使用 telnet 命令进入 Dubbo 调试,中文输入将会乱码,使用 SecureCRT telnet 就不会乱码。感觉是 mac 平台终端问题,不知道各位小伙伴有没有碰到过?有解决办法的小伙伴,欢迎留个言。

注意点

Invoke 命令内部使用 FastJson,将字符串转化为 Json 对象。

每日一技|巧用  Telnet 调试 Dubbo 服务

tips: 如果参数为 数组,ListMap,小黑哥有时候想不到怎么转成 Json 字符串。现在知道底层原理了,就好办了。

可以先将数组,List,Map 对象参数组装好,然后调用 FastJson JSONObject.toJSONString(array) 得到 json 字符串。

不同版本解码方式不一样

2.5.3 解码方式:
list = (List) JSON.parse("[" + args + "]", List.class);

2.7.0 解码方式:
list = JSON.parseArray("[" + args + "]", Object.class);

某些 Dubbo 版本 POJO 参数对象需要在 json 字符串中需要指定 class,明确参数类型,例如:

1{
2    "name""11",
3    "age"12,
4    "class":"xx.xx.Pojo"
5}

如果没有传入,将会调用失败,相关问题可以参见这个 Issue:https://github.com/apache/dubbo/issues/3105。所以如果方法参数为 POJO 对象,最好在 json 中传入 class

0x03. select 命令与意外之喜

Dubbo 最新版本,如果服务存在多个相同参数的重载方法,且没有使用 class 来明确参数类型,提示用户使用新增的select 命令来选择要调用的方法。

每日一技|巧用  Telnet 调试 Dubbo 服务

小黑哥在测试 select 命令的过程中发现了一个 Bugselect 执行未选中的方法。如上,我使用 select 1希望执行 1. hello(HelloRequest),但是实际上执行的是 2. hello(HelloRequestV2)。当输入  select 2 时,执行结果如下:

每日一技|巧用  Telnet 调试 Dubbo 服务

这个 Bug 详情参考小黑哥提的这个 issue https://github.com/apache/dubbo/issues/5707。这个修复很简单,小黑哥已提交 PR 修复该 Bug

没想到,写这篇文章过程中,还能发现一个 Bug,然后成为 Dubbo Committer,哈哈哈哈。

每日一技|巧用  Telnet 调试 Dubbo 服务

0x04. 总结

Dubbo Telnet命令,调用invoke命令,可以调用 Dubbo 服务,解决一些生产应急事件。

但是玩归玩,闹归闹,别把生产开玩笑。

随意使用 invoke 命令还是存在一定危险性,只要知道方法类,服务参数组装规则,就可以远程执行方法,所以生产系统建议按需申请 invoke权限。

往期精彩回顾
持续输出|我的 2019 年

Leader:这样的 Bug 你也写的出来???

定时任务莫名停止,Spring 定时任务存在 Bug???


每日一技|巧用  Telnet 调试 Dubbo 服务


原文始发于微信公众号(程序通事):每日一技|巧用 Telnet 调试 Dubbo 服务