调用WebService遇HTTP 401未授权问题及认证方案排查

从你的报错栈和尝试的方案来看，核心问题出在WSDL加载阶段的认证和不同客户端框架（JAX-WS/Axis2）的认证机制不兼容上，下面针对你的情况给出具体解决办法：

问题根源拆解 #

1. URL中直接嵌入username:password的方式，JAX-WS客户端默认并不支持这种格式的认证解析，所以直接访问WSDL会返回401。
2. 方案1的Authenticator.setDefault()仅对JAX-WS的独立测试环境有效，但你的应用中使用了Axis2框架，Axis2有自己的HTTP处理逻辑，不会复用Java全局的Authenticator配置。
3. 方案2手动请求WSDL返回200，但JAX-WS客户端创建Service实例时会自行发起WSDL请求，并不会复用你自定义的HttpURLConnection配置，因此仍会触发401错误。

针对性解决办法 #

1. 针对JAX-WS客户端：同时处理WSDL加载和服务调用的认证 #

如果你的代码是基于JAX-WS生成的客户端（报错栈中的org.tempuri.Api是JAX-WS生成的），可以先手动获取带认证的WSDL流，再创建Service实例，避免加载WSDL时的401：

import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;
import java.util.Base64;
import javax.xml.ws.BindingProvider;
import javax.xml.ws.Service;
import javax.xml.namespace.QName;

// 1. 手动获取带Basic认证的WSDL输入流
String wsdlUrlStr = "http://10.XXX.15.XX/ClientExt/NewAPI/api.asmx?wsdl";
URL wsdlUrl = new URL(wsdlUrlStr);
HttpURLConnection conn = (HttpURLConnection) wsdlUrl.openConnection();

String userCredentials = username + ":" + password;
String basicAuth = "Basic " + Base64.getEncoder().encodeToString(userCredentials.getBytes(StandardCharsets.UTF_8));
conn.setRequestProperty("Authorization", basicAuth);
InputStream wsdlInputStream = conn.getInputStream();

// 2. 用本地流创建Service，避免远程请求WSDL
QName serviceQName = new QName("http://tempuri.org/", "Api"); // 替换为你的WSDL命名空间和服务名
Service service = Service.create(wsdlInputStream, serviceQName);

// 3. 获取Port并设置调用时的认证
Api port = service.getPort(Api.class);
BindingProvider bindingProvider = (BindingProvider) port;
bindingProvider.getRequestContext().put(BindingProvider.USERNAME_PROPERTY, username);
bindingProvider.getRequestContext().put(BindingProvider.PASSWORD_PROPERTY, password);

// 之后正常调用服务方法即可
port.yourWebServiceMethod();

2. 针对Axis2客户端：使用Axis2专属的认证配置 #

如果你的应用实际是用Axis2调用服务（报错中出现org.apache.axis2.AxisFault），需要直接配置Axis2的ServiceClient认证参数：

import org.apache.axis2.transport.http.HTTPConstants;
import org.apache.commons.codec.binary.Base64;

// 假设ApiStub是Axis2生成的客户端Stub
ApiStub stub = new ApiStub("http://10.XXX.15.XX/ClientExt/NewAPI/api.asmx");

// 方式一：设置Axis2内置的认证参数
stub._getServiceClient().getOptions().setProperty(HTTPConstants.AUTHENTICATION_USER, username);
stub._getServiceClient().getOptions().setProperty(HTTPConstants.AUTHENTICATION_PASS, password);

// 方式二：手动设置Basic认证头（如果方式一不生效）
String authHeader = "Basic " + Base64.encodeBase64String((username + ":" + password).getBytes());
stub._getServiceClient().getOptions().setProperty(HTTPConstants.HEADER_AUTHORIZATION, authHeader);

// 调用服务方法
stub.yourWebServiceMethod();

3. 避免常见误区 #

• 不要依赖URL中嵌入用户名密码的方式：多数WebService客户端框架（包括JAX-WS和Axis2）都不支持这种格式的认证解析。
• 区分全局Authenticator和框架专属配置：Authenticator.setDefault()是Java全局设置，但Web容器或框架可能会覆盖或忽略它，优先使用客户端框架自带的认证配置。

内容的提问来源于stack exchange，提问作者jolly