JDWP握手超时根本不是网络慢，而是协议层MTU与内核缓冲区不匹配导致数据包截断或重传激增；需在JVM启动参数中显式指定packetSize=1024，同步调大net.core.rmem_max至65536，并在VSCode launch.json中配置数字型"packetSize": 1024。
JDWP 握手超时根本不是网络慢，而是协议层 MTU 不匹配
VSCode 连不上远程 Java 进程，报 Connection refused 或卡在 Waiting for JVM to start listening...，大概率不是防火墙或端口没开，而是 JDWP 协议握手阶段因 MTU 和内核缓冲区不匹配导致数据包被截断或重传激增。这种问题在 ARM 板、容器、Kubernetes Pod 等资源受限环境尤为明显。
典型现象是：telnet localhost 5005 能通，但 VSCode 死活连不上；或者连上后断点响应极慢、变量加载超时。日志里高频出现 qXfer:features:read 失败或 PacketSize=2000 被拒绝。
- JDWP 握手初期会协商
PacketSize，默认常为 2000 字节 - 若远程主机的
net.core.rmem_max小于该值（如嵌入式 Linux 常设为 16384），内核会丢弃超长 TCP 分段 - SSH 隧道本身不改包大小，但加密开销会让实际 IP 包更接近 MTU 上限（通常 1500）
- GDB/VSCode 的 JDWP 客户端不会自动降级 PacketSize，卡住等待 ACK
强制指定 JDWP PacketSize 并调大内核接收缓冲区
不能依赖“默认能用”，必须显式控制握手参数。JVM 启动时加 -agentlib:jdwp 参数的同时，要配合 transport 层配置，而非只调端口。
- 启动命令中加入
transport=dt_socket,server=y,suspend=n,address=127.0.0.1:5005,timeout=30000——timeout防止握手无限挂起 - 关键追加：
packetSize=1024（推荐值，兼容绝大多数网络栈和容器环境） - 完整示例：
-agentlib:jdwp=transport=dt_socket,server=y,suspend=n,address=127.0.0.1:5005,timeout=30000,packetSize=1024 - 远程主机执行：
sudo sysctl -w net.core.rmem_max=65536（临时生效）；写入/etc/sysctl.conf持久化 - 验证是否生效：
sysctl net.core.rmem_max输出应 ≥ 65536
VSCode launch.json 必须匹配 packetSize，且禁用自动探测
launch.json 里的配置不是“可选补充”，而是 JDWP 握手协商的参与方。VSCode Java 扩展默认会发 qSupported 包试探能力，若未对齐 packetSize，它就收不到有效响应。
立即学习“Java免费学习笔记（深入）”；
- 确保
configurations中包含"packetSize": 1024字段（注意是数字，非字符串） - 禁用自动协商：加
"allowUntrusted": true和"skipServerVerification": true（仅调试环境） - 不要留空
"hostName"，明确写"hostName": "localhost"—— 即使走 SSH 隧道，VSCode 仍需知道本地终点是 loopback - 错误示范：
"packetSize": "1024"（字符串类型会被忽略）或漏掉该字段（回退到默认 2000，触发失败）
容器与边缘设备场景下额外检查项
在 Docker、K3s 或 ARM 开发板上，光调 JVM 和 VSCode 还不够。底层网络命名空间、cgroup 限流、甚至 CPU 频率缩放都会干扰 JDWP 握手时序。
- 容器启动时加
--sysctl net.core.rmem_max=65536（Docker CLI）或securityContext.sysctls（K8s） - 确认容器内
/proc/sys/net/core/rmem_max可写且值正确（某些镜像只读挂载/proc） - ARM 板若用
linux-generic内核，检查是否启用TCP window scaling：cat /proc/sys/net/ipv4/tcp_window_scaling应为 1 - 避免在
entrypoint中用sleep 1启动 JVM —— JDWP 握手窗口很窄，延迟启动易错过首包 - 最简验证法：在远程主机上用
java -agentlib:jdwp=... -jar app.jar启动后，立刻在本地跑nc -v localhost 5005；若连接建立后立即断开，就是 packetSize 不匹配
真正卡住 JDWP 握手的，从来不是“连不通”，而是“连上了却说不上话”。packetSize 是 JVM、内核、SSH 隧道、VSCode 四方之间最脆弱的隐式契约，任何一方偏离都会让整个调试链路静默失效。
