项目中使用 Feign 调用 HTTP API 时,出现一个错误:HttpRetryException: cannot retry due to redirection, in streaming mode
feign.RetryableException: cannot retry due to redirection, in streaming mode executing POST <api_url>
at feign.FeignException.errorExecuting(FeignException.java:67)
……
Caused by: java.net.HttpRetryException: cannot retry due to redirection, in streaming mode
at sun.net.www.protocol.http.HttpURLConnection.followRedirect0(Unknown Source)
at sun.net.www.protocol.http.HttpURLConnection.followRedirect(Unknown Source)
……
由于搜索不到解决方案,自己用Spring MVC 写了一个简单的带有 redirect API,使用feign请求,没有任何问题。首先怀疑是 API 方 (使用python编写)的问题。
于是分别使用 postman 和 JavaScript ajax 调用该接口,发现没有问题。结合异常的意思:“无法在流模式下使用重定向”。
那么问题就出在 Feign 使用的底层 http client 框架,对于重定向的处理策略不同。Feign 默认使用 java.net.HttpURLConnection。更改为 okhttp3 后,正常。于是猜想:
不同的http client 对于重定向的判定策略不同。
接下来根据源码验证了这一猜想。
不同的http client 对于重定向的判定策略不同。
通过排查来验证结论:
一、HttpURLConnection 的重定向策略
通过跟踪 sun.net.www.protocol.http.HttpURLConnection 的源码(followRedirect方法),发现一些重定向的规则:
- 响应状态码码必须是3xx
- 响应头必须包含Location
- location中url的协议与原来的url协议相同。
- 非流模式。(如果使用流模式,直接抛出上面的异常)
- ……
如果通过body发送参数,请求就会是流模式,直接抛出异常。在自己的模拟接口中加上 RequestBody 错误复现。
说明:
1、sun.net.www.protocol.http.HttpURLConnection 是 java.net.HttpURLConnection 子类。
2、使用JDK1.8。
附上部分源码(反编译的,命名比较差)
/*
* 判断是否追踪重定向,如果返回 true则执行根据响应头中的Location请求重定向。返回 false 不执行操作。
*/
private boolean followRedirect() throws IOException {
URL localURL1;
// 判断实例的设置
if (!(getInstanceFollowRedirects())) {
return false;
}
// 响应码 300 301 302 303 305 307 追踪重定向
int i = getResponseCode();
if ((i < 300) || (i > 307) || (i == 306) || (i == 304)) {
return false;
}
// 判断响应头是否包含 Location
String str = getHeaderField("Location");
if (str == null) {
return false;
}
try {
// 重定向的url的协议与原url的协议是否相同(HTTP或HTTPS)
localURL1 = new URL(str);
if (!(this.url.getProtocol().equalsIgnoreCase(localURL1.getProtocol())))
return false;
} catch (MalformedURLException localMalformedURLException) {
localURL1 = new URL(this.url, str);
}
/* 判断是否有权限访问重定向的URL */
URL localURL2 = localURL1;
this.socketPermission = null;
SocketPermission localSocketPermission = URLtoSocketPermission(localURL1);
if (localSocketPermission != null)
try {
return ((Boolean) AccessController
.doPrivilegedWithCombiner(new PrivilegedExceptionAction(this, str, i, localURL2) {
public Boolean run() throws IOException {
return Boolean.valueOf(HttpURLConnection.access$300(this.this$0, this.val$loc,
this.val$stat, this.val$locUrl0));
}
}, null, new Permission[] { localSocketPermission })).booleanValue();
} catch (PrivilegedActionException localPrivilegedActionException) {
throw ((IOException) localPrivilegedActionException.getException());
}
// 进一步判断
return followRedirect0(str, i, localURL1);
}
/*
* 进一步判断是否追踪重定向
*/
private boolean followRedirect0(String paramString, int paramInt, URL paramURL) throws IOException {
disconnectInternal();
/*流模式下,不能进行重定向。(只要有请求体就是流模式)*/
if (streaming())
throw new HttpRetryException("cannot retry due to redirection, in streaming mode", paramInt, paramString);
}
…………
return true;
}
二、Apache HttpClient 的重定向规则
跟踪源码,HttpClient 的重定向规则十分清晰,扩展性强。重定向实现逻辑位于 org.apache.http.impl.execchain.RedirectExec.execute 方法,首先判断配置是否允许重定向然后交给org.apache.http.client.RedirectStrategy 判断。
public CloseableHttpResponse execute( final HttpRoute route, final HttpRequestWrapper request, final HttpClientContext context, final HttpExecutionAware execAware) throws IOException, HttpException {
//首先判断配置中是否孕育重定向
if (config.isRedirectsEnabled() &&
// 接着将重定向判定权交给 RedirectStrategy 来完成
this.redirectStrategy.isRedirected(currentRequest.getOriginal(), response, context)) {
//还会限制重定向的次数
if (redirectCount >= maxRedirects) {
throw new RedirectException("Maximum redirects ("+ maxRedirects + ") exceeded");
}
redirectCount++;
final HttpRequest redirect = this.redirectStrategy.getRedirect(
currentRequest.getOriginal(), response, context);
}
}
默认策略 org.apache.http.impl.client.DefaultRedirectStrategy。规则很简单,只允许 GET 和 HEAD 请求重定向。
/**
* Redirectable methods.
*/
private static final String[] REDIRECT_METHODS = new String[] { HttpGet.METHOD_NAME, HttpHead.METHOD_NAME };
/**
* @since 4.2
*/
protected boolean isRedirectable(final String method) {
for (final String m: REDIRECT_METHODS) {
if (m.equalsIgnoreCase(method)) {
return true;
}
}
return false;
}
说明: 使用 httpclient-4.5.3
三、okhttp 的重定向规则
尚未跟踪源码,从表现来看,okhttp的重定向归则最为宽松。
总结
遇到调用重定向的问题,如果 postman 调用没问题,可以跟踪一下所使用 http client 的重定向归则。