Java中处理HTTP 301重定向：安全读取JSON数据的实践指南-java教程-PHP中文网

Java中处理HTTP 301重定向：安全读取JSON数据的实践指南

花韻仙語

发布： 2025-07-19 13:46:14

原创

536人浏览过

Java中处理HTTP 301重定向：安全读取JSON数据的实践指南

在Java应用中通过URL读取JSON数据时，若遇到301 Moved Permanently重定向导致JSONException，通常是由于使用了不安全的HTTP协议访问了已迁移至HTTPS的资源。解决方案是直接将URL协议从http更改为https，并建议使用HttpURLConnection进行更健壮的网络请求处理，以有效避免此类数据解析错误。

理解问题：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 <html> 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响应。

Find JSON Path Online

Easily find JSON paths within JSON objects using our intuitive Json Path Finder

查看详情

更健壮的网络请求：使用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进行交互。

以上就是Java中处理HTTP 301重定向：安全读取JSON数据的实践指南的详细内容，更多请关注php中文网其它相关文章！