跳到主要内容 WSL2 下 Webots 控制器连接地址错误 10.255.255.254 的修复 | 极客日志
Python AI
WSL2 下 Webots 控制器连接地址错误 10.255.255.254 的修复 在 WSL2 环境下运行 Webots 与 ROS2 时，webots-controller 常因自动推断出错误的 IP 地址（如 10.255.255.254）而启动失败。根本原因是 webots_ros2_driver 错误地将 /etc/resolv.conf 中的 nameserver 当作 Webots 主机地址。解决方案包括启用 mirrored networking 模式使用 127.0.0.1、手动指定业务网卡 IP，或直接修改 utils.py 中的 get_wsl_ip_address 函数返回固定值或读取环境变量。不建议直接修改 /etc/resolv.conf，因其可能被系统重置。
ServerBase 发布于 2026/4/6 更新于 2026/4/13 最近在 WSL2 + ROS2 Humble + Webots 环境中运行 webots_ros2_universal_robot 示例时，发现 webots-controller 启动后立刻退出。日志显示它自动使用了一个明显不对的地址：
[ERROR] [webots_controller_UR5e-3] : process
has
died
[pid 2087, exit code 1, cmd '/opt/ros/humble/share/webots_ros2_driver/scripts/webots-controller --robot-name=UR5e --protocol=tcp --ip-address=10.255.255.254 --port=1234 ...' ]
但当前 WSL2 中明明存在正确可用的业务网卡地址，例如：
eth3 = 192.168.10.88eth1 = 192.168.192.160 一开始很容易怀疑是 Webots 选错了网卡，实际上问题更准确地说是：
webots_ros2_driver 在 WSL2 下自动推断 Webots 主机地址时，错误地读取了 /etc/resolv.conf 中的 nameserver，并把它当成了 Webots 服务器地址。
如果你的 /etc/resolv.conf 恰好包含：
nameserver 10.255.255.254
那么最终 webots-controller 就会拿着这个错误地址去连接，导致启动失败。
问题现象 ros2 launch webots_ros2_universal_robot multirobot_launch.py
[ERROR] [webots_controller_UR5e-3 ]: process has died [pid 2087 , exit code 1 , cmd '/opt/ros/humble/share/webots_ros2_driver/scripts/webots-controller --robot-name=UR5e --protocol=tcp --ip-address=10.255.255.254 --port=1234 ros2 --ros-args -r __ns:=/ur5e -p robot_description:=/opt/ros/humble/share/webots_ros2_universal_robot/resource/ur5e_with_gripper.urdf.xacro -p xacro_mappings:=[' name:=UR5eWithGripper'] -p use_sim_time:=True -p set_robot_state_publisher:=True --params-file /opt/ros/humble/share/webots_ros2_universal_robot/resource/ros2_control_config.yaml' ]
而 ifconfig 中实际存在多个 IPv4 地址，例如：
eth1: 192.168.192.160 eth3: 192.168.10.88
看起来像是'地址选错了'，但继续深挖会发现，它根本不是从正常网卡选择逻辑里挑出来的。
为什么会出现 10.255.255.254
1. WSL2 可能自动生成 nameserver 在一些 WSL2 环境中，/etc/resolv.conf 里可能会出现这样的内容：
nameserver 10.255.255.254
这类地址本质上是 DNS 相关配置，并不是 Webots 服务地址。
2. webots_ros2_driver 误把 nameserver 当成 Webots 主机地址 webots_ros2_driver 在 WSL2 环境下会尝试自动获取 Windows 主机地址，以便 Linux 侧的 controller 去连接 Windows 侧运行的 Webots。
问题在于，它的推断逻辑会去读取 /etc/resolv.conf 的 nameserver，然后直接把它当成目标地址返回。
如果 resolv.conf 里是 127.0.0.53，就会拿 127.0.0.53
如果是 8.8.8.8，就会拿 8.8.8.8
如果是 10.255.255.254，就会拿 10.255.255.254
--ip-address =10.255 .255.254
这显然不是你真正的 Webots 主机地址，所以连接失败。
到底应该用哪个地址
情况一：WSL2 使用 mirrored networking（镜像网络） 如果你开启了 mirrored networking，那么 最推荐的地址不是某张物理网卡的 IP，而是 127.0.0.1。
Windows 上运行 Webots
WSL2 中运行 ROS2 controller
两者之间直接通过 127.0.0.1 通信
这种方式通常更稳定，也更符合 mirrored networking 的设计思路。
情况二：特殊 NAT / 多网卡 / 指定业务网络场景 如果你没有使用 mirrored networking，或者你的环境明确要求通过某张业务网卡通信，那么可以手工指定固定地址，例如：
如何确认自己是否使用 mirrored networking [wsl2]
networkingMode =mirrored
[wsl2]
networkingMode =mirrored
dnsTunneling =true
autoProxy =true
firewall =true
修改后记得在 Windows PowerShell 中执行：
为什么不建议去改 /etc/resolv.conf 有些排查思路会想到：既然 webots_ros2_driver 是从 /etc/resolv.conf 里读 nameserver，那我直接把里面内容改掉不就行了？
1. 语义不对 /etc/resolv.conf 是 DNS 配置文件，不是 Webots 主机地址配置文件。
通过修改它来'顺便修好' Webots，属于误打误撞，不是正统修法。
2. WSL2 可能自动重建它 WSL2 会自动管理一些网络相关配置，/etc/resolv.conf 可能会被系统重新生成。
也就是说你手工改完，后面可能又被覆盖掉。
不要去伪造 DNS 配置，而是直接修正 webots_ros2_driver 的地址推断逻辑。
最直接的解决方法：直接修改 webots_ros2_driver
适用场景
启动时自动生成的 --ip-address 明显不对
日志里出现 10.255.255.254
日志里出现 127.0.0.53
日志里出现其它明显不是 Webots 主机的地址
已经确认问题来自 webots_ros2_driver 自动推断逻辑
详细操作步骤
第一步：找到 utils.py dpkg -L ros-humble-webots-ros2-driver | grep 'utils.py'
/opt/ ros/humble/ local/lib/ python3.10 /dist-packages/ webots_ros2_driver/ utils.py
第二步：备份原文件 sudo cp /opt/ros/humble/local/lib/python3.10/dist-packages/webots_ros2_driver/utils.py \
/opt/ros/humble/local/lib/python3.10/dist-packages/webots_ros2_driver/utils.py.bak
第三步：打开文件编辑 sudo vim /opt/ros/humble/local/lib/python3.10/dist-packages/webots_ros2_driver/utils.py
def get_wsl_ip_address ():
你大概率会在里面看到与读取 /etc/resolv.conf 有关的逻辑，如：
def get_wsl_ip_address ():
try :
file = open ('/etc/resolv.conf' , 'r' )
except IOError:
return '127.0.0.1'
try :
for line in file:
if len (line) == 0 or line[0 ] == '#' or line[0 ] == ';' :
continue
tokens = line.split()
if len (tokens) == 0 :
continue
if tokens[0 ] == 'nameserver' :
file.close()
if len (tokens[1 ]) == 0 :
return '127.0.0.1'
return tokens[1 ]
finally :
file.close()
第四步：改成固定返回值
方案 A：mirrored networking 场景，推荐返回 127.0.0.1 如果你的 WSL2 使用的是 mirrored networking，最推荐改成：
def get_wsl_ip_address ():
return "127.0.0.1"
方案 B：明确指定某张业务网卡，例如 192.168.10.88 如果你的环境必须通过固定网段访问，也可以直接写死成：
def get_wsl_ip_address ():
return "192.168.10.88"
你不是 mirrored networking
或者 Windows / Webots 端只能通过该网段连通
方案 C：做成可配置版本（推荐） import os
def get_wsl_ip_address ():
return os.environ.get("WEBOTS_HOST_IP" , "127.0.0.1" )
export WEBOTS_HOST_IP=192.168.10.88
export WEBOTS_HOST_IP=127.0.0.1
重启并验证 ros2 launch webots_ros2_universal_robot multirobot_launch.py
重点观察日志里 controller 的启动参数，确认 --ip-address 已经不再是：
快速自检
1. 检查 /etc/resolv.conf
nameserver 10.255.255.254
那就说明当前系统确实存在 WSL2 生成 nameserver 的情况。
2. 测试目标端口连通性 假设 Webots controller 监听的是 1234 端口，可以测试：
nc -vz 127.0.0.1 1234
nc -vz 192.168.10.88 1234
如果你是 mirrored networking，建议优先验证：
如果只有指定业务网卡地址能通，那就把 get_wsl_ip_address() 固定成对应 IP。
问题总结
Webots 自动选错了 eth3
或者 Linux 网卡优先级异常
WSL2 环境中 /etc/resolv.conf 可能存在 10.255.255.254 这样的 nameserver
webots_ros2_driver 在 WSL2 下错误地读取了该 nameserver并将它当成 Webots 主机地址传给 webots-controller
最终导致 controller 连接失败并退出
直接修复 webots_ros2_driver 的地址推断逻辑，避免它继续误用 /etc/resolv.conf。
参考
Cyberbotics 社区关于 webots_ros2_driver 在 WSL2 下错误读取 resolv.conf nameserver 的问题讨论
Microsoft WSL 关于 mirrored networking 与 localhost 通信说明
Microsoft WSL 关于 resolv.conf / 网络自动管理相关说明
注：本文重点是记录问题现象与实际有效的修复手段，适合当前环境快速落地。如果后续官方修复了 webots_ros2_driver 的 WSL2 地址推断逻辑，建议优先升级官方版本，避免长期维护本地补丁。
微信扫一扫，关注极客日志 微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
相关免费在线工具 RSA密钥对生成器 生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
Mermaid 预览与可视化编辑 基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
curl 转代码 解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具，curl 转代码在线工具，online
Base64 字符串编码/解码 将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
Base64 文件转换器 将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
Markdown 转 HTML 将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
