问题描述与现象
在java应用程序中，当尝试从一个url读取json数据时，如果该url使用的是http://协议，并且服务器配置了从http到https的301 moved permanently重定向，那么客户端可能会遇到以下异常：
- HTTP响应头： 301 Moved Permanently
- Java异常： org.json.JSONException: Value of type java.lang.String cannot be converted to JSONObject
这表明尽管java.net.URL.openStream()在某些情况下可以自动跟随重定向，但最终接收到的响应内容并非预期的JSON格式，而是一个HTML页面（通常是告知浏览器重定向的页面），导致JSON解析器无法将其转换为JSONObject。
以下是原始的代码片段，展示了数据读取和JSON解析的逻辑：
// 数据读取方法
private static String readUrl(String urlString) throws Exception {
BufferedReader reader = null;
try {
URL url = new URL(urlString);
// openStream() 默认会跟随 3xx 重定向
reader = new BufferedReader(new InputStreamReader(url.openStream()));
StringBuffer buffer = new StringBuffer();
int read;
char[] chars = new char[1024];
while ((read = reader.read(chars)) != -1)
buffer.append(chars, 0, read);
return buffer.toString();
} finally {
if (reader != null)
reader.close();
}
}
// 调用示例，尝试读取JSON数据
String url = "http://webservice.fanart.tv/v3/movies/" + movie.id + "?api_key=" + apikey;
List<String> enClearLogos = new ArrayList<>();
try {
// 期望这里返回JSON字符串，但实际上可能返回HTML
JSONObject json = new JSONObject(readUrl(url));
JSONArray jsonArray = json.getJSONArray("hdmovielogo");
for(int i = 0; i < jsonArray.length(); i++){
JSONObject movieObject = jsonArray.getJSONObject(i);
if (movieObject.getString("lang").equalsIgnoreCase("en"))
enClearLogos.add(movieObject.getString("url"));
}
} catch (Exception e) {
// 捕获到 org.json.JSONException
e.printStackTrace();
}问题根源分析
301 Moved Permanently状态码表示请求的资源已被永久移动到新的位置。在Web服务中，这通常意味着API提供商已将服务从不安全的HTTP协议迁移到安全的HTTPS协议，并强制所有请求通过HTTPS进行。
当客户端使用http://协议发起请求时，服务器会响应一个301状态码，并在响应头中包含Location字段，指向资源的HTTPS地址。尽管java.net.URL.openStream()（底层使用HttpURLConnection）通常会自动跟随这些重定向，但问题在于：
立即学习“Java免费学习笔记（深入）”；
- 重定向响应内容： 服务器在发送301响应时，其响应体可能包含一个HTML页面，用于向浏览器用户解释重定向，而不是空白或直接的JSON数据。
- 协议不匹配： 即使跟随了重定向，如果原始请求是HTTP，并且API服务强制要求HTTPS，那么客户端一开始就应该使用HTTPS协议，以避免不必要的重定向开销和潜在的解析问题。最直接的原因是，API提供方不再维护HTTP服务，所有请求都必须通过HTTPS进行。
解决方案
解决此问题的最直接和有效的方法是，将API请求的URL协议从http://修改为https://。这确保了请求直接发送到安全的、预期的API端点，从而避免了301重定向和随之而来的HTML响应。
修改后的URL示例：
// 将 URL 协议从 http:// 修改为 https:// String url = "https://webservice.fanart.tv/v3/movies/" + movie.id + "?api_key=" + apikey;
通过这一简单的更改，应用程序将直接与HTTPS服务通信，接收到正确的JSON响应，从而避免JSONException。
最佳实践与注意事项
始终优先使用HTTPS： 在进行任何网络通信，尤其是与API交互时，应始终优先使用HTTPS协议。这不仅是为了解决重定向问题，更是为了数据传输的安全性、完整性和隐私性。现代Web服务和API几乎都强制使用HTTPS。
理解HTTP状态码： 熟悉常见的HTTP状态码，特别是3xx（重定向）、4xx（客户端错误）和5xx（服务器错误）系列，有助于快速诊断网络请求问题。
-
检查响应内容类型： 在解析响应之前，可以检查HTTP响应的Content-Type头。如果期望JSON，但Content-Type是text/html或其他类型，则应提前识别并处理，避免尝试用JSON解析器处理非JSON内容。
// 示例：使用 HttpURLConnection 检查 Content-Type URL url = new URL(urlString); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("GET"); // 设置请求方法 int responseCode = connection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { String contentType = connection.getHeaderField("Content-Type"); if (contentType != null && contentType.contains("application/json")) { // 继续读取和解析JSON BufferedReader reader = new BufferedReader(new InputStreamReader(connection.getInputStream())); // ... 读取内容 ... } else { System.err.println("Unexpected Content-Type: " + contentType); // 处理非JSON响应，例如读取为字符串并打印 } } else { System.err.println("HTTP Error Code: " + responseCode); // 处理非200响应，例如读取错误流 } -
使用更健壮的HTTP客户端库： 对于复杂的网络请求，推荐使用更专业的HTTP客户端库，如Apache HttpClient、OkHttp或Spring的RestTemplate/WebClient。这些库提供了更高级的功能，如：
- 更精细的重定向控制（例如，是否自动跟随重定向，最大重定向次数）。
- 连接池管理。
- 更灵活的请求构建和响应处理。
- 内置的错误处理机制。
API文档查阅： 在遇到API问题时，务必查阅API提供商的官方文档。API版本更新或协议变更通常会在文档中说明。
通过遵循上述最佳实践，可以有效避免和解决因协议不匹配和重定向导致的JSON数据读取问题，提高应用程序的健壮性和可靠性。
