理解问题：HTTP 301重定向与JSON解析失败
在进行网络请求时，我们可能会遇到http状态码为301 moved permanently的情况。这意味着请求的资源已经被永久性地移动到新的url。当客户端使用http://协议访问一个资源，而该资源已被服务器配置为强制使用https://协议时，服务器会返回一个301响应，告知客户端应使用新的https地址。
原始代码中，使用URL.openStream()方法来读取URL内容：
private static String readUrl(String urlString) throws Exception {
BufferedReader reader = null;
try {
URL url = new URL(urlString);
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();
}
}当请求的URL（例如http://webservice.fanart.tv/v3/movies/...）触发301重定向时，URL.openStream()在某些情况下可能会尝试自动跟踪重定向。然而，问题在于，服务器返回的301响应体通常包含一个简单的HTML页面，指示资源已移动，而不是预期的JSON数据。当后续代码尝试将这个HTML内容解析为JSONObject时，就会抛出org.json.JSONException: Value of type java.lang.String cannot be converted to JSONObject异常。这清楚地表明，接收到的数据不是JSON格式，而是HTML。
核心解决方案：强制使用HTTPS协议
解决此问题的最直接和最有效的方法是，在构建URL时，直接使用https://协议而非http://。许多API提供商为了数据传输的安全性，会强制要求使用HTTPS。当客户端直接使用HTTPS请求时，就避免了最初的HTTP到HTTPS的重定向过程，从而直接获取到正确的JSON数据。
将原始URL字符串：
立即学习“Java免费学习笔记（深入）”；
String url = "http://webservice.fanart.tv/v3/movies/" + movie.id + "?api_key=" + apikey;
修改为：
String url = "https://webservice.fanart.tv/v3/movies/" + movie.id + "?api_key=" + apikey;
通过这一简单的更改，应用程序将直接向API的HTTPS端点发起请求，绕过不必要的重定向，并有望直接接收到期望的JSON响应。
更健壮的网络请求：使用HttpURLConnection
尽管直接切换到HTTPS可以解决当前问题，但为了构建更健壮、更可控的网络请求逻辑，建议使用java.net.HttpURLConnection而非简单的URL.openStream()。HttpURLConnection提供了对HTTP请求的更多控制，包括获取响应状态码、设置请求头、处理重定向等。
以下是使用HttpURLConnection改进readUrl方法的示例：
import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.URL;
public class JsonDataReader {
private static String readUrl(String urlString) throws Exception {
HttpURLConnection connection = null;
BufferedReader reader = null;
try {
URL url = new URL(urlString);
connection = (HttpURLConnection) url.openConnection();
// 设置请求方法
connection.setRequestMethod("GET");
// 允许自动重定向（HttpURLConnection默认开启，但明确设置更清晰）
connection.setInstanceFollowRedirects(true);
// 设置连接和读取超时（可选，但推荐）
connection.setConnectTimeout(5000); // 5秒连接超时
connection.setReadTimeout(10000); // 10秒读取超时
int responseCode = connection.getResponseCode();
// 检查响应码，确保是成功状态（200 OK）或重定向后成功
if (responseCode >= 200 && responseCode < 300) {
reader = new BufferedReader(new InputStreamReader(connection.getInputStream()));
StringBuilder buffer = new StringBuilder();
String line;
while ((line = reader.readLine()) != null) {
buffer.append(line);
}
return buffer.toString();
} else {
// 处理非成功响应，例如打印错误信息
String errorMessage = "HTTP Error: " + responseCode + " - " + connection.getResponseMessage();
// 如果需要，可以读取错误流
try (BufferedReader errorReader = new BufferedReader(new InputStreamReader(connection.getErrorStream()))) {
String errorLine;
StringBuilder errorBuffer = new StringBuilder();
while ((errorLine = errorReader.readLine()) != null) {
errorBuffer.append(errorLine);
}
errorMessage += "\nError Body: " + errorBuffer.toString();
} catch (Exception e) {
// 忽略读取错误流的异常
}
throw new Exception(errorMessage);
}
} finally {
if (reader != null) {
try {
reader.close();
} catch (Exception e) {
e.printStackTrace(); // 打印关闭流的异常
}
}
if (connection != null) {
connection.disconnect(); // 关闭连接
}
}
}
public static void main(String[] args) {
// 假设 movie.id 和 apikey 已定义
String movieId = "629542"; // 示例ID
String apikey = "YOUR_API_KEY"; // 请替换为你的API密钥
String url = "https://webservice.fanart.tv/v3/movies/" + movieId + "?api_key=" + apikey;
try {
String jsonString = readUrl(url);
// 示例：解析JSON数据
org.json.JSONObject json = new org.json.JSONObject(jsonString);
org.json.JSONArray jsonArray = json.getJSONArray("hdmovielogo");
java.util.List<String> enClearLogos = new java.util.ArrayList<>();
for(int i = 0; i < jsonArray.length(); i++){
org.json.JSONObject movieObject = jsonArray.getJSONObject(i);
if (movieObject.getString("lang").equalsIgnoreCase("en"))
enClearLogos.add(movieObject.getString("url"));
}
System.out.println("英文高清Logo URLs: " + enClearLogos);
} catch (Exception e) {
System.err.println("Error reading JSON data: " + e.getMessage());
e.printStackTrace();
}
}
}代码改进点说明：
- 使用HttpURLConnection： 提供更细粒度的控制，可以检查HTTP响应码。
- 响应码检查： 在读取输入流之前，先检查connection.getResponseCode()。只有当响应码为2xx（成功）时才尝试解析JSON。对于3xx重定向，HttpURLConnection通常会默认自动跟随，但明确检查有助于调试。对于4xx或5xx错误，可以抛出更具体的异常。
- 超时设置： setConnectTimeout()和setReadTimeout()有助于防止网络请求无限期挂起。
- 资源关闭： 在finally块中确保BufferedReader和HttpURLConnection都被正确关闭，释放资源。
JSON数据解析与异常处理
在获取到JSON字符串后，进行解析时也需要注意健壮性。org.json库在遇到非JSON格式的数据时会抛出JSONException。因此，将JSON解析部分放入try-catch块中是至关重要的。
// ... (前略，已获取到 jsonString)
try {
JSONObject json = new JSONObject(jsonString);
// 确保键存在且是JSONArray类型
if (json.has("hdmovielogo") && json.get("hdmovielogo") instanceof JSONArray) {
JSONArray jsonArray = json.getJSONArray("hdmovielogo");
List<String> enClearLogos = new ArrayList<>();
for(int i = 0; i < jsonArray.length(); i++){
JSONObject movieObject = jsonArray.getJSONObject(i);
if (movieObject.has("lang") && movieObject.getString("lang").equalsIgnoreCase("en")) {
if (movieObject.has("url")) {
enClearLogos.add(movieObject.getString("url"));
}
}
}
// ... 处理 enClearLogos
} else {
System.err.println("JSON structure invalid: 'hdmovielogo' not found or not a JSONArray.");
}
} catch (JSONException e) {
System.err.println("Error parsing JSON data: " + e.getMessage());
e.printStackTrace();
} catch (Exception e) { // 捕获其他可能的异常
System.err.println("An unexpected error occurred: " + e.getMessage());
e.printStackTrace();
}JSON解析注意事项：
- has()方法： 在尝试获取JSON对象或数组之前，使用JSONObject.has("key")方法检查键是否存在，避免JSONException。
- 类型检查： 使用instanceof或get(key)返回的类型判断，确保获取到的值是预期的类型（如JSONArray或JSONObject）。
- 细致的异常处理： 不仅捕获JSONException，还要考虑其他网络或IO相关的异常。
注意事项与最佳实践
- 始终验证API文档： 在集成任何第三方API时，仔细阅读其官方文档至关重要。文档会明确指出推荐的协议（HTTP/HTTPS）、认证方式、请求限制以及可能返回的错误码。
- 网络请求超时： 为网络连接和数据读取设置合理的超时时间，防止因网络问题导致应用程序长时间无响应。
- 使用现代HTTP客户端库： 对于更复杂的应用，考虑使用成熟的第三方HTTP客户端库，如Apache HttpClient、OkHttp或Spring的RestTemplate/WebClient。这些库提供了更高级的功能（如连接池、拦截器、异步请求、更好的错误处理机制）和更简洁的API，可以大大简化网络请求的开发和维护。
- 日志记录： 记录网络请求的URL、响应状态码、耗时以及任何异常信息，这对于问题诊断和性能监控非常有帮助。
通过遵循这些实践，可以有效避免因URL重定向和不当的JSON解析而导致的常见问题，确保应用程序能够稳定、安全地与外部API进行交互。
