HttpURLConnection 是 Java 标准库中轻量级 HTTP 客户端,需手动处理连接、超时、请求头、输入输出流及资源关闭;适合简单场景,但生产环境推荐 Apache HttpClient 或 OkHttp。

HttpURLConnection 是 Java 标准库中用于发起 HTTP 请求的轻量级类,无需额外依赖,适合简单场景。它底层基于 URL 类,使用起来直接但需手动处理连接、请求头、输入输出流和异常。
创建连接并设置基本参数
通过 new URL(url).openConnection() 获取 HttpURLConnection 实例,强制转型后可配置超时、请求方法等:
- 调用 setConnectTimeout() 和 setReadTimeout() 避免长时间卡住(单位毫秒)
- 用 setRequestMethod("GET") 或 "POST" 指定方法,注意大小写必须全大写
- 如需发送数据,必须调用 setDoOutput(true);如需读取响应,调用 setDoInput(true)(默认为 true)
- 可调用 setRequestProperty("Content-Type", "application/json") 添加请求头
发送 POST 请求并写入数据
POST 场景下需主动写出请求体,常见于提交表单或 JSON:
- 获取 getOutputStream() 后,用 writeBytes() 或包装成 OutputStreamWriter 写字符串
- 写完务必调用 flush() 和 close(),否则服务端可能收不到完整数据
- 若传 JSON,建议 UTF-8 编码:new OutputStreamWriter(os, "UTF-8")
读取响应结果与状态码
响应处理分两步:先检查状态码,再读取内容:
立即学习“Java免费学习笔记(深入)”;
- 用 getResponseCode() 判断是否成功(2xx),非 2xx 时 getErrorStream() 可读错误响应
- 正常响应用 getInputStream() 读取,推荐包装为 BufferedReader 逐行读取
- 注意响应编码:可通过 getContentType() 解析 charset,或默认按 UTF-8 处理
记得关闭连接释放资源
HttpURLConnection 不会自动关闭底层 socket,必须显式断开:
- 无论成功失败,都应在 finally 块或 try-with-resources 中调用 disconnect()
- 输入输出流也需 close(),避免文件描述符泄漏
- 实际开发中更推荐用 Apache HttpClient 或 OkHttp,它们自动管理连接池和重试
不复杂但容易忽略细节,尤其超时设置和流关闭。标准库够用,但生产环境建议升级工具链。










