使用旧SQL Server jTDS驱动连接服务器时遇Network is unreachable错误

排查与修复步骤 #

• 检查macOS防火墙权限
  打开「系统设置」-「网络」-「防火墙」，确认已允许DBeaver或其依赖的Java进程发起出站连接。若防火墙处于开启状态，手动将DBeaver添加到允许列表。

• 验证服务器网络连通性
  用以下命令测试macOS到SQL Server服务器的基础连通性：

  # 测试服务器IP/域名的可达性
  ping your-server-ip-or-domain
  # 测试SQL Server端口（默认1433，替换为你的实际端口）
  telnet your-server-ip 1433
  

  若telnet无法连通，说明macOS与服务器间的网络路径存在阻断，需排查路由、VPN或服务器端防火墙限制。

• 更换驱动版本或类型
  旧版jTDS驱动可能存在macOS兼容性缺陷：

  • 尝试升级到jTDS最新稳定版（如1.3.2）；
  • 替换为微软官方的SQL Server JDBC驱动（mssql-jdbc），在DBeaver中切换驱动类型后重新配置连接。

• 检查Java环境兼容性
  打开DBeaver偏好设置-「连接」-「驱动」-「JDBC驱动」，查看当前驱动使用的Java版本。尝试切换为Oracle JDK或OpenJDK 8/11版本，避免macOS自带Java的兼容性问题。

• 关闭网络代理
  若开启了全局代理或VPN，暂时关闭后重试连接，代理规则可能阻断了jTDS的连接请求。

• 重置macOS网络配置
  执行以下命令重置当前网络接口（需管理员权限）：

  sudo ifconfig en0 down && sudo ifconfig en0 up
  

  或在「系统设置」-「网络」中选中当前网络，点击「高级」-「TCP/IP」-「Renew DHCP Lease」。

错误提示：IOException: Network is unreachable Network is unreachable

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