java.net.HttpURLConnection 踩坑经历

本文详细探讨了Java网络库HttpURLConnection中的两个常见问题:自动静默重试与默认3XX跳转行为。提供了如何通过系统属性设置或方法调用来禁用这些默认行为的解决方案。

java.net.HttpURLConnection

这个是java自带的网络库,接手项目后遇到了两个问题:

1.自动静默的重试
2.默认进行3XX跳转

自动静默的重试

这个查阅了一些资料发现,是java类库自带的bug,不过在2006设计者已经出了解决方案,只不过由于要兼容以前版本,并没有修改 java.net.HttpURLConnection 这个库的内部实现,只是增加了一个开关,可以人为选择关闭。

//服务端关闭方式
System.setProperty("sun.net.http.retryPost", "false");
// Android 无法这样设置只能使用
httpConn.setChunkedStreamingMode(0);

默认进行3XX跳转

虽然现在基本不在乎跳不跳转,但是还是有用户是不希望进行跳转的,自我接手 SDK 以来还是出现了自动跳转给客户带来了问题,所以研究了下 java 的网络类库(以前根本没有用过,都是做一些web项目,网络库应用的太少)

// 关闭方式
httpConn.setInstanceFollowRedirects(false);
<think> 我们使用java.net.HttpURLConnection实现HTTPS请求时,需要处理SSL证书验证等安全性问题。以下是详细步骤和注意事项: ### 步骤1: 创建URL对象 首先,创建一个指向HTTPS地址的URL对象。 ```java URL url = new URL("https://example.com/api"); ``` ### 步骤2: 打开连接并转换为HttpURLConnection 打开连接,并强制转换为HttpURLConnection类型。 ```java HttpURLConnection connection = (HttpURLConnection) url.openConnection(); ``` ### 步骤3: 处理SSL证书问题(可选) 如果目标服务器使用自签名证书或证书不受信任,需要自定义SSL上下文。通常在生产环境中应使用受信任的证书,但开发测试时可能需要忽略证书验证。 #### 方法A: 信任所有证书(不推荐用于生产) 创建一个忽略所有证书验证的信任管理器,并初始化SSLContext。 ```java import javax.net.ssl.*; import java.security.cert.X509Certificate; // 创建信任所有证书的TrustManager TrustManager[] trustAllCerts = new TrustManager[]{ new X509TrustManager() { public java.security.cert.X509Certificate[] getAcceptedIssuers() { return null; } public void checkClientTrusted(X509Certificate[] certs, String authType) { } public void checkServerTrusted(X509Certificate[] certs, String authType) { } } }; // 初始化SSLContext SSLContext sslContext = SSLContext.getInstance("SSL"); sslContext.init(null, trustAllCerts, new java.security.SecureRandom()); HttpsURLConnection.setDefaultSSLSocketFactory(sslContext.getSocketFactory()); // 忽略主机名验证 HttpsURLConnection.setDefaultHostnameVerifier((hostname, session) -> true); ``` #### 方法B: 加载特定证书(推荐) 如果使用自签名证书,可将其导入到信任库,然后通过以下方式加载: ```java KeyStore keyStore = // 加载包含证书的KeyStore TrustManagerFactory tmf = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm()); tmf.init(keyStore); SSLContext sslContext = SSLContext.getInstance("TLS"); sslContext.init(null, tmf.getTrustManagers(), null); HttpsURLConnection.setDefaultSSLSocketFactory(sslContext.getSocketFactory()); ``` ### 步骤4: 设置请求方法 设置HTTP请求方法(GET、POST等)。 ```java connection.setRequestMethod("GET"); ``` ### 步骤5: 设置请求头 根据需要设置请求头。 ```java connection.setRequestProperty("Content-Type", "application/json"); connection.setRequestProperty("Accept", "application/json"); ``` ### 步骤6: 处理请求体(POST请求) 如果是POST请求,需要写入请求体。 ```java connection.setDoOutput(true); // 允许写入请求体 try (OutputStream os = connection.getOutputStream()) { byte[] input = "request body".getBytes("utf-8"); os.write(input, 0, input.length); } ``` ### 步骤7: 获取响应 读取响应代码和响应内容。 ```java int responseCode = connection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { // 成功 try (BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()))) { String inputLine; StringBuilder response = new StringBuilder(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } System.out.println(response.toString()); } } else { // 处理错误 try (BufferedReader in = new BufferedReader(new InputStreamReader(connection.getErrorStream()))) { // 读取错误流 } } ``` ### 步骤8: 断开连接 最后断开连接。 ```java connection.disconnect(); ``` ### 完整示例代码(GET请求,忽略证书验证) ```java import javax.net.ssl.*; import java.io.BufferedReader; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import java.security.cert.X509Certificate; public class HttpsClient { public static void main(String[] args) throws Exception { // 设置信任所有证书 TrustManager[] trustAllCerts = new TrustManager[]{ new X509TrustManager() { public X509Certificate[] getAcceptedIssuers() { return null; } public void checkClientTrusted(X509Certificate[] certs, String authType) {} public void checkServerTrusted(X509Certificate[] certs, String authType) {} } }; SSLContext sslContext = SSLContext.getInstance("SSL"); sslContext.init(null, trustAllCerts, new java.security.SecureRandom()); HttpsURLConnection.setDefaultSSLSocketFactory(sslContext.getSocketFactory()); HttpsURLConnection.setDefaultHostnameVerifier((hostname, session) -> true); // 创建URL和连接 URL url = new URL("https://example.com"); HttpURLConnection connection = (HttpURLConnection) url.openConnection(); connection.setRequestMethod("GET"); // 读取响应 int responseCode = connection.getResponseCode(); if (responseCode == HttpURLConnection.HTTP_OK) { try (BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()))) { String inputLine; StringBuilder response = new StringBuilder(); while ((inputLine = in.readLine()) != null) { response.append(inputLine); } System.out.println(response.toString()); } } else { System.out.println("GET request failed. Response Code: " + responseCode); } connection.disconnect(); } } ``` ### 注意事项 - **安全性**:信任所有证书会带来安全风险,仅用于测试。生产环境应使用有效证书或导入自签名证书到信任库。 - **异常处理**:代码中应妥善处理`IOException`和`SSLException`等异常。 - **HTTP/HTTPS重定向**:默认情况下,HttpURLConnection自动重定向,可通过`setInstanceFollowRedirects`方法控制。 - **连接超时**:使用`setConnectTimeout`和`setReadTimeout`设置超时时间,避免网络问题导致线程阻塞。 ### 相关引用 - [Java官方文档-HttpsURLConnection](https://docs.oracle.com/javase/8/docs/api/javax/net/ssl/HttpsURLConnection.html) 提供了HTTPS连接的详细说明[^1]。 - [Java官方文档-TrustManager](https://docs.oracle.com/javase/8/docs/api/javax/net/ssl/TrustManager.html) 介绍了如何实现自定义信任管理器[^2]。 §§相关问题§§ 1. 如何在Java中处理HTTPS请求的SSL证书验证? 2. 如何将自签名证书导入Java信任库? 3. JavaHttpURLConnection与Apache HttpClient有何区别? 4. 如何设置HttpsURLConnection的超时时间? </think> 要使用 `java.net.HttpURLConnection` 实现 HTTPS 请求,需要处理 SSL/TLS 证书验证和协议配置。以下是详细步骤和代码示例: --- ### 解决方案步骤 #### 1. **基础 HTTPS 请求(忽略证书验证 - 仅测试环境使用)** ```java import javax.net.ssl.*; import java.io.BufferedReader; import java.io.InputStreamReader; import java.net.HttpURLConnection; import java.net.URL; import java.security.cert.X509Certificate; public class HttpsExample { public static void main(String[] args) throws Exception { // 1. 创建信任所有证书的 TrustManager TrustManager[] trustAllCerts = new TrustManager[]{ new X509TrustManager() { public X509Certificate[] getAcceptedIssuers() { return null; } public void checkClientTrusted(X509Certificate[] certs, String authType) {} public void checkServerTrusted(X509Certificate[] certs, String authType) {} } }; // 2. 初始化 SSLContext 并设置信任管理器 SSLContext sslContext = SSLContext.getInstance("TLS"); sslContext.init(null, trustAllCerts, new java.security.SecureRandom()); HttpsURLConnection.setDefaultSSLSocketFactory(sslContext.getSocketFactory()); // 3. 忽略主机名验证 HttpsURLConnection.setDefaultHostnameVerifier((hostname, session) -> true); // 4. 创建 URL 并打开连接 URL url = new URL("https://example.com"); HttpURLConnection conn = (HttpURLConnection) url.openConnection(); // 5. 设置请求方法 conn.setRequestMethod("GET"); // 6. 读取响应 try (BufferedReader in = new BufferedReader( new InputStreamReader(conn.getInputStream()))) { String line; StringBuilder response = new StringBuilder(); while ((line = in.readLine()) != null) { response.append(line); } System.out.println(response); } } } ``` #### 2. **生产环境推荐:使用有效证书** ```java // 省略信任管理器配置(使用默认 JRE 信任库) public class ValidHttpsExample { public static void main(String[] args) throws Exception { URL url = new URL("https://example.com"); HttpsURLConnection conn = (HttpsURLConnection) url.openConnection(); // 启用证书验证(默认行为) conn.setHostnameVerifier((hostname, session) -> { // 可自定义主机名验证逻辑 return hostname.equals("example.com"); }); // 设置请求头和超时 conn.setRequestMethod("GET"); conn.setConnectTimeout(5000); conn.setReadTimeout(5000); // 处理响应 int status = conn.getResponseCode(); if (status == 200) { // HTTP_OK try (BufferedReader in = new BufferedReader( new InputStreamReader(conn.getInputStream()))) { // 读取响应内容 } } } } ``` --- ### 关键配置说明 1. **SSLContext 初始化** - 使用 `SSLContext.getInstance("TLS")` 指定 TLS 协议 - 通过 `init(null, trustAllCerts, secureRandom)` 设置信任管理器 2. **主机名验证** - `HostnameVerifier` 用于验证服务器域名是否匹配证书 - 生产环境必须严格验证(示例中使用了 `hostname.equals()`) 3. **证书管理** - **测试环境**:使用自定义 `X509TrustManager` 忽略证书验证 - **生产环境**: - 将服务器证书导入 JRE 信任库: ```bash keytool -import -alias myserver -file server.crt -keystore $JAVA_HOME/lib/security/cacerts ``` - 或使用系统默认信任库(无需额外配置) 4. **超时设置** - `setConnectTimeout()`:连接超时(毫秒) - `setReadTimeout()`:读取数据超时 --- ### 注意事项 1. **安全性警告** - `TrustManager` 信任所有证书的方案**仅用于测试**,在生产环境中会带来中间人攻击风险[^1]。 2. **协议选择** - 优先使用 `TLSv1.2` 或更高版本: ```java SSLContext.getInstance("TLSv1.2"); ``` 3. **异常处理** - 捕获 `SSLHandshakeException` 处理证书错误 - 捕获 `SocketTimeoutException` 处理超时 4. **HTTP 方法支持** ```java // 设置 POST 请求示例 conn.setRequestMethod("POST"); conn.setDoOutput(true); // 允许写入请求体 try (OutputStream os = conn.getOutputStream()) { os.write("data=example".getBytes()); } ``` --- ### 完整生产级示例 ```java import javax.net.ssl.HttpsURLConnection; import java.net.URL; import java.io.*; public class SecureHttpsClient { public static void main(String[] args) { try { URL url = new URL("https://api.example.com/data"); HttpsURLConnection conn = (HttpsURLConnection) url.openConnection(); // 强制使用 TLSv1.2 System.setProperty("https.protocols", "TLSv1.2"); // 严格主机名验证 conn.setHostnameVerifier((hostname, session) -> hostname.equals("api.example.com")); conn.setRequestMethod("GET"); conn.setConnectTimeout(10000); int status = conn.getResponseCode(); if (status == HttpsURLConnection.HTTP_OK) { try (BufferedReader in = new BufferedReader( new InputStreamReader(conn.getInputStream()))) { String line; while ((line = in.readLine()) != null) { System.out.println(line); } } } else { System.err.println("HTTP Error: " + status); } } catch (Exception e) { e.printStackTrace(); } } } ``` --- ### 常见问题解决 - **证书错误 (PKIX path validation failed)** 将服务器证书添加到信任库: ```bash keytool -import -trustcacerts -alias server -file server.crt -keystore cacerts ``` - **协议不支持错误** 启动时指定协议版本: ```bash java -Dhttps.protocols=TLSv1.2 -jar app.jar ``` - **主机名不匹配** 在 `HostnameVerifier` 中实现正确的域名检查逻辑。
评论 1
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值