NModbus4 TcpListener绑定格式有效IP时启动失败问题

TcpListener绑定指定IP时在Start()阶段抛出异常，和IP格式校验是否通过、NModbus4库逻辑无关，核心原因是你传入的IP地址没有实际绑定到当前程序运行主机的网卡上。
127.0.0.1属于系统默认预留的回环地址，所有启用TCP/IP协议栈的主机都会默认将该地址绑定到回环网卡，因此绑定该地址永远可以正常启动。而手动输入的类似50.50.50.50这类地址，只要没被配置到本机的物理/虚拟网卡上，哪怕格式完全合法，也无法完成绑定。

除了IP不存在的问题，以下情况也会导致启动失败：

• 目标端口已被其他进程占用
• 运行程序的账号没有对应端口的绑定权限（例如Linux/macOS下绑定1024以下端口需要root权限，Windows下部分端口被系统保留无法绑定）
• 系统防火墙、终端安全软件拦截了端口绑定操作

通用场景（推荐） #

如果不需要限制从站只响应某一块网卡的请求，直接绑定IPAddress.Any（对应0.0.0.0）即可监听本机所有网卡的指定端口，无需手动配置单IP，适配绝大多数Modbus TCP从站部署场景，修改后的代码如下：

case "TCP":
try
{
  // 绑定所有网卡地址，无需手动指定单IP
  TcpListener slaveTcpListener = new TcpListener(IPAddress.Any, Port);
  slaveTcpListener.Start();
  slave = ModbusTcpSlave.CreateTcp(SlaveID, slaveTcpListener);
  slave.DataStore = DataStoreFactory.CreateDefaultDataStore(MaxCoil, MaxDI, MaxIR);
  slave.DataStore.DataStoreReadFrom += new EventHandler<DataStoreEventArgs>(dataStore_DataStoreReadFrom);
  slave.ModbusSlaveRequestReceived += Slave_ModbusSlaveRequestReceived;
  slave.Listen();
}
catch (SocketException ex)
{
  // 禁止空吞异常，通过Socket错误码可直接定位问题
  // 错误码10049：绑定IP不存在；错误码10048：端口被占用
  Console.WriteLine($"从站启动失败，错误码：{ex.SocketErrorCode}，错误信息：{ex.Message}");
}

指定单IP绑定场景 #

如果业务要求必须绑定单个指定IP，先在配置校验环节增加本机IP枚举逻辑：遍历当前主机所有物理、虚拟网卡上绑定的IPv4地址，只有用户输入的IP存在于枚举结果中时，才允许传入TcpListener，否则直接提示IP配置无效。

不要使用空catch块吞掉异常，专门捕获SocketException类型，通过错误码可以快速定位问题：

• 错误码10049：对应WSAEADDRNOTAVAIL，即要绑定的IP未配置在本机网卡上，就是本次遇到的问题
• 错误码10048：对应WSAEADDRINUSE，即指定端口已经被其他进程占用，更换空闲端口或关闭占用进程即可

内容的提问来源于stack exchange，提问作者Hyun Joon Jang