ProtocolException是Java中继承自IOException的受检异常，表示HTTP协议违规，非网络故障；主因包括GET请求调用getOutputStream()、setDoOutput(true)未配setDoInput(false)、手动设置Content-Length或Transfer-Encoding、Android低版本响应首行不合规。
ProtocolException 是 Java 中一个受检异常（checked exception），属于 IOException 的子类，意味着你必须显式捕获或声明抛出。它不是网络连不上、也不是超时，而是 JVM 在协议层面直接判定“你构造的请求或解析的响应违反了 HTTP 基本规则”，当场拒绝执行。排查重点不在网络环境，而在代码对 HttpURLConnection 的使用是否合规。
GET 请求误写请求体是最常见触发点
HTTP 规范明确规定：GET 方法不得携带请求体。但很多开发者在设完 setRequestMethod("GET") 后，又调用了 getOutputStream() 或设置了 setDoOutput(true)，JVM 会立即抛出 ProtocolException: Method does not support output。
- 检查所有 GET 请求代码，确认没有
getOutputStream()、setDoOutput(true)或手动写入字节流的操作 - 若需传参，统一用 URL 查询参数（
?key=value&...），不要试图往 GET 里塞 body - 如逻辑上需要发数据且不关心响应，改用 POST，并明确设置
setRequestMethod("POST")和setDoOutput(true)
POST/PUT 带 body 却不读响应导致校验失败
设了 setDoOutput(true) 表示要发数据，但 HttpURLConnection 默认也开启 setDoInput(true) —— 它会尝试读响应头来校验状态。如果你只写不读（比如发日志后直接 return），连接关闭时 JVM 仍会尝试收包，失败即报 ProtocolException。
- 如果确定要读响应，必须在获取响应码后调用
getInputStream()或getErrorStream()，哪怕只调用read()一次再 close - 如果完全不需要响应（如异步埋点），请显式关闭输入：在
setDoOutput(true)后加setDoInput(false) - 避免复用同一个 connection 实例多次调用
getResponseCode()或connect()
手设 Content-Length 或 Transfer-Encoding 是高危操作
这两个头部由 HttpURLConnection 自动计算和管理。手动设置极易与实际内容不一致，触发协议校验失败。
立即学习“Java免费学习笔记（深入）”；
- 绝对不要调用
setRequestProperty("Content-Length", "...")—— 让 JVM 自己算 - 不要手动设
Transfer-Encoding: chunked；如需分块上传，只用setChunkedStreamingMode(8192) - DELETE 或 HEAD 等无 body 方法，切勿设
setDoOutput(true)，否则 JVM 会期待有 body 却读到 0 字节
Android 低版本对响应首行极其敏感
API 19 及以下系统中，ProtocolException: Unexpected status line 很可能源于服务端返回的响应首行不合规：多空格、含 BOM、大小写混用（如 http/1.1 200 ok）、或 HTTP/1.0 响应带 Transfer-Encoding。
- 服务端应确保首行为严格格式：
HTTP/1.1 200 OK（单空格、全大写、无隐藏字符） - 客户端优先切换为 OkHttp 或 Apache HttpClient，它们对非标响应容错更强
- 若必须用 HttpURLConnection，可在 debug 阶段用抓包工具（如 Charles）查看原始响应首行是否干净
