调试ZWCAD.NET插件客户端Socket无法连接问题

一、先排除基础网络连通性问题 #

• 在ZWCAD运行的机器上，执行ping 服务器IP确认物理链路通畅
• 用telnet 服务器IP 目标端口或者PowerShell命令Test-NetConnection 服务器IP -Port 目标端口，直接验证服务器端口是否能被当前机器访问
• 对比AutoCAD环境下的测试结果：如果AutoCAD下端口测试正常，ZWCAD下失败，说明问题集中在ZWCAD进程的网络权限或环境限制上

二、追踪Socket调用的执行细节 #

• 在插件的Socket连接逻辑中添加精准错误日志，捕获并记录异常信息：

  try
  {
      var socket = new Socket(AddressFamily.InterNetwork, SocketType.Stream, ProtocolType.Tcp);
      socket.Connect(new IPEndPoint(IPAddress.Parse("服务器IP"), 目标端口));
      // 记录连接成功日志
  }
  catch (SocketException ex)
  {
      // 重点记录错误码和描述，比如ex.ErrorCode、ex.Message
      // 常见错误码对应：10060=连接超时，10061=服务器拒绝连接，10048=端口被占用
  }
  

• 用Visual Studio附加到ZWCAD进程，单步调试Socket连接代码，观察每一步的执行状态和异常触发点
• 查看ZWCAD的插件加载日志，确认是否存在加载时的权限警告或API调用限制

三、排查防火墙与安全软件拦截 #

• 临时关闭系统防火墙（Windows Defender防火墙），测试Socket连接：若恢复正常，说明防火墙规则阻止了ZWCAD进程
• 进入防火墙“高级设置”，检查是否存在针对ZWCAD.exe的出站拦截规则；若没有，手动添加允许ZWCAD访问目标IP和端口的出站规则
• 检查第三方安全软件的网络拦截日志，确认是否有拦截ZWCAD网络请求的记录，将ZWCAD.exe加入软件信任列表

四、验证ZWCAD进程权限与环境差异 #

• 右键以管理员身份启动ZWCAD，测试Socket连接：部分网络操作需要管理员级权限才能执行
• 检查ZWCAD的兼容模式设置：右键ZWCAD.exe→属性→兼容性，取消勾选兼容模式选项（兼容模式可能限制网络功能）
• 确认插件使用的.NET版本与ZWCAD支持的版本一致：比如ZWCAD可能依赖.NET Framework 4.8，若插件用了更高/更低版本，可能导致底层网络调用异常

五、检查ZWCAD自身的网络限制 #

• 查看ZWCAD系统设置中是否有“网络访问管控”类选项，部分企业版CAD会内置网络限制功能
• 确认当前ZWCAD版本是否存在已知的Socket调用兼容性问题，可联系官方技术支持核实

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