如何解决 Axis2 中的 NonRepeatableRequestException 异常？

2024-07-28 16:24:38

如何解决设置代理属性时出现的 NonRepeatableRequestException 异常？

在使用 Axis2 (1.8) 和 Java 8、HttpClient 4.5 开发 Web 服务的过程中，你是否遇到过设置代理属性时抛出 NonRepeatableRequestException 异常的情况？这个问题通常出现在重复使用 ServiceClient 实例进行多次请求，并且第一次请求设置了代理，而后续请求没有设置代理或者设置了不同的代理时。

本文将深入探讨 NonRepeatableRequestException 异常背后的原因，并提供两种有效的解决方案，帮助你彻底解决这个问题。

HTTP 协议与异常的根源

要理解 NonRepeatableRequestException 异常发生的原因，我们需要先了解 HTTP 协议的一些特性。当我们第一次通过代理服务器发送请求时，会在 HTTP 请求头部添加 Proxy-Authorization 字段，用于向代理服务器进行身份验证。

HTTP 协议规定，对于同一个连接，Proxy-Authorization 字段只能设置一次。然而，Axis2 的 ServiceClient 在默认情况下会启用连接池。这意味着，后续请求可能会复用之前的连接。如果此时没有设置代理或者设置了不同的代理，就会导致 HTTP 请求头部中的 Proxy-Authorization 字段与实际情况不符，从而触发 NonRepeatableRequestException 异常。

解决方案一：每次请求都设置代理

最直接的解决方案是在每次发送请求之前，都重新设置代理属性。即使你没有使用代理，也要将代理属性设置为 null。

以下代码示例展示了如何在每次请求之前设置代理属性：

// 在每次发送请求之前执行以下代码

Options options = stub._getServiceClient().getOptions();
HttpTransportProperties.ProxyProperties props = null; // 如果不需要代理，设置为null

if (isProxyRequired()) { // 判断是否需要使用代理
    props = new ProxyProperties();
    props.setProxyName("http://sample.co.jp");
    props.setPassWord("Password");
    props.setProxyPort(8090);
    props.setUserName("UserName");
}

options.setProperty(HTTPConstants.PROXY, props);

这种方案虽然简单易行，但会增加代码的冗余度。此外，每次请求都需要重新设置代理属性，可能会对性能造成轻微影响。

解决方案二：禁用连接池

另一种解决方案是禁用连接池。这样每次请求都会创建新的连接，从根本上避免了 Proxy-Authorization 字段冲突的问题。

以下代码示例展示了如何禁用连接池：

// 在创建ServiceClient实例后执行以下代码

stub._getServiceClient().getHttpClient().getHttpConnectionManager()
    .getParams().setParameter(HttpMethodParams.USE_EXPECT_CONTINUE, Boolean.FALSE);

这种方案可以彻底解决 NonRepeatableRequestException 异常。但是，连接的创建和销毁都会带来一定的开销，因此禁用连接池可能会影响性能，尤其是在高并发场景下。