本文详解 Android 通过 USB-Ethernet 转换器与笔记本电脑建立 Modbus TCP 直连通信时，因 IP 地址缺失导致 ENETUNREACH 错误的根本原因及完整解决方案，涵盖静态 IP 配置、子网规划、防火墙设置与代码健壮性优化。
本文详解 android 通过 usb-ethernet 转换器与笔记本电脑建立 modbus tcp 直连通信时，因 ip 地址缺失导致 `enetunreach` 错误的根本原因及完整解决方案，涵盖静态 ip 配置、子网规划、防火墙设置与代码健壮性优化。
在使用 USB-to-Ethernet 适配器将 Android 设备（如手机或平板）直连笔记本电脑进行 Modbus TCP 通信时，开发者常遇到如下典型错误：
java.net.ConnectionException: failed to connect to /192.168.29.244 (port 502) from /::(port 0): connect failed: ENETUNREACH (network is unreachable)
该错误并非代码逻辑缺陷，而是网络层连通性缺失所致：当 Android 设备通过 USB-Ethernet 连接到笔记本电脑（而非路由器/交换机）时，它不会自动获取 IP 地址——因为此时不存在 DHCP 服务器；而 Android 系统默认不为 USB 网络接口分配 IPv4 地址，导致 InetAddress.getByName("192.168.29.244") 解析成功，但底层路由表无对应直连子网，最终触发 ENETUNREACH。
✅ 正确配置步骤（双向静态 IP）
需为两端设备手动配置互为网关的私有子网地址，推荐使用 192.168.100.0/24 网段（避开常用 WiFi 子网，避免冲突）：
| 设备 | 接口 | IP 地址 | 子网掩码 | 备注 |
|---|---|---|---|---|
| 笔记本电脑 | 有线网卡 | 192.168.100.1 | 255.255.255.0 | 作为 Modbus TCP 服务端 |
| Android 设备 | USB-Ethernet | 192.168.100.2 | 255.255.255.0 | 需通过 ADB 或第三方工具配置 |
▶ 在 Android 上配置静态 IP（需 root 或支持 USB 网络配置的设备）
多数现代 Android（Android 10+）可通过以下方式设置（无需 root）：
启用 USB 网络共享（关键）：
设置 → 热点和网络 → 更多连接方式 → USB 网络共享 → 开启（此操作会激活 rndis0 或 usb0 接口，并允许系统识别以太网连接）。-
使用 adb shell 配置静态 IP（推荐）：
adb shell su # 若设备已 root ip addr add 192.168.100.2/24 dev rndis0 ip link set rndis0 up
⚠️ 注意：接口名可能为 usb0、eth0 或 rndis0，可通过 ip link show 查看活跃接口。
-
验证连通性：
ping -c 3 192.168.100.1 # 应成功
▶ 在笔记本电脑上配置（Windows/macOS/Linux）
Windows：
控制面板 → 网络和 Internet → 网络连接 → 右键“以太网” → 属性 → IPv4 → 手动设置：
IP：192.168.100.1，子网掩码：255.255.255.0，网关/DNS 留空。-
macOS/Linux：
# macOS sudo ifconfig en0 inet 192.168.100.1 netmask 255.255.255.0 # Ubuntu/Debian sudo ip addr add 192.168.100.1/24 dev eth0 sudo ip link set eth0 up
▶ Modbus TCP 服务端准备（笔记本）
确保 Modbus 服务监听在 0.0.0.0:502（而非仅 127.0.0.1:502），并关闭防火墙临时规则：
- Windows：Windows Defender 防火墙 → 高级设置 → 入站规则 → 新建规则 → 端口 502 → 允许连接
- Linux：sudo ufw allow 502/tcp
▶ 客户端代码优化建议
原代码中未校验网络接口可达性，易掩盖配置问题。建议增强健壮性：
// ✅ 改进：添加网络可达性预检
InetAddress addr = InetAddress.getByName(ip);
if (!addr.isReachable(2000)) { // 超时 2s
throw new IOException("Target host unreachable: " + ip);
}
con = new TCPMasterConnection(addr);
con.setPort(port);
con.setTimeout(3000); // 建议设为 3s 以上，避免瞬时丢包误判
con.connect();
? 关键注意事项总结
- ❌ 不要依赖 WiFi + USB-Ethernet 混合模式：务必关闭 WiFi 和移动数据（Airplane Mode + 开启 USB 网络共享），避免路由混淆；
- ✅ 子网必须唯一且直连：192.168.100.x/24 是安全选择，避免与家庭路由器（如 192.168.1.x）重叠；
- ? 确认接口名与状态：Android 中 ip link show 必须看到 rndis0 状态为 UP 且有 inet 地址；
- ? 禁用笔记本的 Internet 连接共享（ICS）：除非你刻意构建 NAT 网络，否则直连应为二层互通，ICS 会引入额外路由复杂度；
- ? 测试顺序：先 ping → 再 telnet 192.168.100.1 502（验证端口开放）→ 最后运行 App。
完成上述配置后，TCPMasterConnection 将能稳定建立 socket 连接，ENETUNREACH 错误彻底消失。本质是补全了“直连以太网”的网络栈基础——IP 层可达性，而非应用层问题。
