IDEA在WSL Ubuntu初始化项目遇Connect timed out错误求助

日志里出现的172.29.189.138是WSL虚拟网卡的内部IP，端口是IDEA与WSL内部服务通信的临时端口，故障源于WSL网络配置异常或端口映射失效，以下是针对性解决步骤：

1. 重置WSL网络核心配置 #

• 关闭所有WSL实例：

  wsl --shutdown
  

• 以管理员身份打开Windows命令提示符，重启WSL服务：

  net stop LxssManager
  net start LxssManager
  

• 重新启动WSL，执行ip addr查看eth0网卡的最新inet地址（格式类似172.x.x.x）

2. 修正IDEA的WSL连接参数 #

• 打开IDEA，进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle（Maven项目对应Maven > Runner）
• 在Gradle JVM（或JRE）选项中，点击右侧的...进入WSL配置界面
• 选择对应的WSL分发版，将连接地址手动修改为刚才查到的eth0新IP；或者切换为Automatic模式，让IDEA自动适配最新网络地址
• 保存配置后重新尝试初始化项目

3. 规避端口冲突问题 #

• 在WSL中编辑/etc/sysctl.conf文件，添加端口范围限制：

  echo "net.ipv4.ip_local_port_range = 49152 65535" | sudo tee -a /etc/sysctl.conf
  

• 执行命令使配置生效：

  sudo sysctl -p
  

  此操作可避免IDEA尝试使用被系统占用的低端口

4. 检查WSL本地防火墙 #

• 执行sudo ufw status查看WSL防火墙状态，若处于开启状态，添加允许IDEA通信的规则：

  sudo ufw allow from 192.168.0.0/16 to any port 45000:65535
  

• 若测试需要，可临时关闭WSL防火墙：

  sudo ufw disable
  

内容的提问来源于stack exchange，提问作者Иван Дёгтев