Go-Zero BFF无法找到ETCD中已注册RPC服务Key问题求助

问题描述 #

使用Go-Zero框架开发项目，包含1个BFF API服务和postsRpc、gauthRpc、usersRpc三个RPC服务，BFF依赖这三个RPC服务。通过docker-compose部署了ETCD等中间件（端口映射2379:2379），三个RPC服务已成功注册到ETCD（通过etcdctl可查看到对应key和服务地址），但启动BFF时出现panic：

API server listening at: 127.0.0.1:2913
2023/12/13 21:05:21 rpc dial: etcd://127.0.0.1:2379/users.rpc, error: context deadline exceeded, make sure rpc service "users.rpc" is already started

原因分析 #

从报错信息和ETCD注册记录来看，核心问题是BFF无法访问RPC服务注册的实际地址，具体可能的原因包括：

• RPC服务注册的是局域网IP而非BFF可访问的地址：ETCD中注册的users.rpc地址为192.168.31.119:8081，若BFF运行环境（比如容器内）无法直接访问该局域网IP，就会触发连接超时。
• Go-Zero自动注册地址逻辑问题：RPC服务配置ListenOn: 0.0.0.0:8081时，框架会自动获取主机对外IP注册到ETCD，若该IP在BFF的网络环境不可达，直接导致连接失败。
• 端口或防火墙限制：宿主机的8081端口可能被防火墙拦截，或端口被其他进程占用，导致BFF无法建立连接。

解决建议 #

方案1：强制RPC服务注册本地回环地址（本地开发场景） #

修改三个RPC服务的配置，添加AdvertiseOn字段，指定注册到ETCD的地址为127.0.0.1，确保BFF通过本地地址即可访问：

# users.rpc配置示例
Name: users.rpc
ListenOn: 0.0.0.0:8081
AdvertiseOn: 127.0.0.1:8081 # 强制注册本地回环地址
Etcd:
  Hosts:
  - 127.0.0.1:2379
  Key: users.rpc

修改后重启RPC服务，通过etcdctl确认注册地址变为127.0.0.1:8081，再启动BFF即可。

方案2：确保BFF与RPC服务网络互通（多环境部署场景） #

如果BFF在容器内运行，RPC服务在宿主机：

• 将BFF容器设置为宿主机网络模式（docker-compose中配置network_mode: host），让容器直接访问宿主机局域网IP。
• 或在docker-compose中为RPC服务配置端口映射，同时修改RPC服务的AdvertiseOn为容器可访问的宿主机地址。

方案3：检查端口与防火墙规则 #

• 确认端口未被占用：

lsof -i :8081

• 检查防火墙是否开放目标端口：

sudo iptables -L -n | grep 8081

若未开放，添加端口允许规则：

sudo iptables -A INPUT -p tcp --dport 8081 -j ACCEPT

方案4：延长BFF RPC连接超时时间 #

在BFF的RPC配置中添加超时参数，避免因网络延迟导致的超时：

UserRpc:
  Etcd:
    Hosts:
    - 127.0.0.1:2379
    Key: users.rpc
  Timeout: 5000 # 单位：毫秒，延长连接等待时长

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