记 java.net.ConnectException: Connection refused 错误的一种解决办法

在工作中遇到一个服务调用另一个WebService wsdl时报 java.net.ConnectException: Connection refused 错误折腾了很多最后才解决，在这里记录一下。

一、报错主要信息

java.net.ConnectException: Connection refused
java.lang.RuntimeException: org.codehaus.xfire.fault.XFireFault: Couldn't send message.
......
Caused by: org.codehaus.xfire.fault.XFireFault: Couldn't send message.
	at org.codehaus.xfire.fault.XFireFault.createFault(XFireFault.java:89)
	at org.codehaus.xfire.handler.OutMessageSender.invoke(OutMessageSender.java:30)
	at org.codehaus.xfire.handler.HandlerPipeline.invoke(HandlerPipeline.java:131)
	at org.codehaus.xfire.client.Invocation.invoke(Invocation.java:75)
	at org.codehaus.xfire.client.Client.invoke(Client.java:335)
	at org.codehaus.xfire.client.Client.invoke(Client.java:349)
	at com.ygsoft.ecp.service.ws.client.WSCaller.call(WSCaller.java:46)
	... 78 more
Caused by: org.codehaus.xfire.XFireException: Couldn't send message.
	at org.codehaus.xfire.transport.http.HttpChannel.sendViaClient(HttpChannel.java:145)
	at org.codehaus.xfire.transport.http.HttpChannel.send(HttpChannel.java:48)
	at org.codehaus.xfire.handler.OutMessageSender.invoke(OutMessageSender.java:26)
	... 83 more
Caused by: java.net.ConnectException: Connection refused
	at java.net.PlainSocketImpl.socketConnect(Native Method)
	at java.net.PlainSocketImpl.doConnect(PlainSocketImpl.java:351)
	at java.net.PlainSocketImpl.connectToAddress(PlainSocketImpl.java:211)
	at java.net.PlainSocketImpl.connect(PlainSocketImpl.java:200)
	at java.net.SocksSocketImpl.connect(SocksSocketImpl.java:366)

二、解决方案

因为报错的地方是一段已经运行了很久的老代码，并且在多个环境运行都没有问题，在解决问题的时候第一时间想到的就是被调用的服务或环境配置方面可能出了问题。后面经过反复确认被调用的服务没有问题，并且报错的环境与客户的正式环境的配置并无差异，然而客户的正式环境没有问题。在几乎尝试完所有的办法之后回归到代码层面发现服务调用的地方有一点不严谨，抱着试一试的态度修改了代码，没想到居然成功了。

修改前的代码：

final String url = "http://" + ipAndPort + "/soaware/jbi/xxxxService/main.wsdl";
final String methodName = "receiveData";
final WebServiceClient webSvr = new WebServiceClient();
webSvr.setUrl(url);
webSvr.callMethod(methodName, param);

修改后的代码：

final String url = "http://" + ipAndPort + "/soaware/jbi/xxxxService/main.wsdl";
final String nameSpace = "http://soaware.xxx.com/inform";
final String methodName = "receiveData";
final WebServiceClient webSvr = new WebServiceClient();
webSvr.setUrl(url);
webSvr.callMethod("",new javax.xml.namespace.QName(nameSpace, methodName), param);

由以上两段代码可以看出，修改前的代码在调用WebService服务时缺少了nameSpace（命名空间）加的信息，而在修改后加上了nameSpace（命名空间）的信息后的就没有Connection refused 的报错。

三、总结

在遇到调用另一个WebService wsdl时报 java.net.ConnectException: Connection refused 错误时笔者建议按以下步骤排查解决问题：

1. 检查本地服务调用代码是否异常（比如缺少nameSpace，URL错误，或者methodName无效等）
2. 检查被调用的服务是否可用
3. 检查被调用的服务中是否存在目标方法
4. 检查本地服务与被调用的服务网络连接是否畅通
5. 检查被调用的服务端口号是否被占用
6. 其他环境配置问题

最后重要的事说三遍：
在遇到报错时不要相信任何一行代码！！！
在遇到报错时不要相信任何一行代码！！！
在遇到报错时不要相信任何一行代码！！！