HttpURLConnection处理变量Header与超时逻辑-java教程-PHP中文网

必须在任何I/O操作前设置Header与超时：先setConnectTimeout/setReadTimeout（单位毫秒），再setRequestProperty/addRequestProperty（中文值需URLEncoder编码），最后调用getInputStream等；顺序错乱将导致配置失效或抛异常。

设置变量 Header 和超时时间，关键在于“时机”和“顺序”——必须在任何 I/O 操作（如 getInputStream()、getOutputStream()、connect()）之前完成，否则配置会被忽略或直接抛异常。

变量 Header 的动态设置方式

Header 名称固定但值来自运行时变量（如 token、trace ID、时间戳），需用 setRequestProperty() 或 addRequestProperty() 动态注入：

单值覆盖型 Header（如 Authorization、Accept）：直接调用 conn.setRequestProperty("Authorization", "Bearer " + token)。重复调用同名 key 会覆盖前值。
多值累加型 Header（如 Cookie、X-Custom-Tag）：用 conn.addRequestProperty("Cookie", "sid=abc") 和 conn.addRequestProperty("Cookie", "lang=zh-CN")，服务端会收到两个独立的 Cookie 行。
中文或特殊字符值：Header 值含中文、空格、斜杠等，必须先用 URLEncoder.encode(value, StandardCharsets.UTF_8) 编码，例如 setRequestProperty("X-Remark", URLEncoder.encode("用户_张三", "UTF-8"))；Header 名（key）始终保持 ASCII，不可编码。
被 JDK 拦截的 Header：Host、Connection、Keep-Alive、Content-Length 等由系统自动管理，手动设置无效，无需也不应干预。

超时时间的合理配比与生效条件

超时不是设了就起作用，它依赖两个前提：单位是毫秒、且必须在连接发起前设定。

connectTimeout：控制 TCP 握手 + TLS 握手完成的最大耗时。设为 3000 表示 3 秒内连不上就失败。适用于网络不通、DNS 解析慢、服务端完全无响应等场景。
readTimeout：从 socket 成功建立后开始计时，等待第一个响应字节 + 接收完整响应体的总上限。设为 10000 是较稳妥的生产起点；若只设 connectTimeout 却漏掉 readTimeout，遇到服务端卡住不发数据，线程将无限阻塞。
重定向场景：若禁用了自动跳转（setInstanceFollowRedirects(false)），每次手动处理 302/307 都要对新连接单独设置超时，原连接的 timeout 不继承。
单位陷阱：写成 setReadTimeout(30) 是 30 毫秒，基本必超；常见误写为秒级数值，务必确认单位是毫秒。

Header 与超时配置的执行顺序规范

所有设置必须严格遵循以下流程，错一步就可能静默失效：

调用 url.openConnection() 获取 HttpURLConnection 实例；
立即设置超时：conn.setConnectTimeout(3000)、conn.setReadTimeout(10000)；
紧接着设置全部 Header：setRequestProperty() 或 addRequestProperty()；
再设置请求方法：conn.setRequestMethod("GET") 或 "POST"；
如需发送请求体（POST/PUT），再调用 conn.setDoOutput(true)；
之后才能调用 getInputStream() / getOutputStream() / connect() —— 此后再设 Header 或超时，JDK 会直接忽略或抛 IllegalStateException。