IntelliJ IDEA在WSL2环境下调试功能无法自动连接问题咨询

方案1：强制WSL内JDK使用IPv4监听调试端口（优先推荐） #

直接从Java进程侧修改网络栈偏好，让调试端口默认绑定到IPv4地址，无需修改IDEA侧逻辑，适配性最高。

• 单项目临时生效：打开对应项目的「运行/调试配置」，在「VM选项」栏添加如下参数后保存，重启调试即可生效：
  -Djava.net.preferIPv4Stack=true
• 全局永久生效：直接在WSL环境的shell配置文件（~/.bashrc/~/.zshrc等）末尾添加环境变量：

  export JAVA_TOOL_OPTIONS="-Djava.net.preferIPv4Stack=true"
  

  保存后执行source ~/.bashrc（对应你使用的shell配置文件），之后所有WSL内启动的Java进程都会默认优先使用IPv4协议。

方案2：配置IDEA优先使用IPv6连接调试端口 #

如果需要保留IPv6使用场景，可以修改Windows端IDEA的网络栈偏好，让调试器默认尝试通过IPv6地址连接端口：

• 找到IDEA的JVM参数配置文件：
  • 手动安装版：IDEA安装目录下bin/idea64.exe.vmoptions（32位系统对应idea.exe.vmoptions）
  • Toolbox安装版：打开Toolbox → 对应IDEA条目右侧设置 → 编辑JVM选项
• 在文件末尾添加如下参数：
  -Djava.net.preferIPv6Addresses=true
• 完全退出IDEA后重新启动即可生效，之后调试器会自动识别IPv6格式的调试端口地址完成连接。

效果验证 #

修改配置后启动调试，可通过资源监视器查看wslhost.exe的端口监听状态：

• 方案1生效时，12345端口会绑定在0.0.0.0（IPv4地址段）
• 方案2生效时，IDEA会自动匹配[::1]格式的IPv6本地地址完成连接，无需手动触发Attach debugger操作。

内容的提问来源于stack exchange，提问作者Dmitrii Gushcha