必须在任何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。
快速验证是否生效的小技巧
Header 是否发出，不能只看代码逻辑，得靠实证：
- 用 Wireshark 或 Charles 抓包，直接查看原始请求头；
- 服务端打日志输出
request.getHeader("Authorization")等字段； - 调用
conn.getHeaderFields()只能拿到响应头（response headers），无法确认请求头是否发出； - 若返回 403/401 却确定 token 正确，大概率是 Header 没发出去或被覆盖 —— 回头检查是否在 I/O 调用后才 setProperty。
