无法调用已注册至Eureka Server的Docker化服务问题求助

1. 修复配置语法错误 #

你的eureka_client.init代码中instance_port参数存在语法问题：

instance_port="<API_PORT"  # 缺少闭合的>，且应为整数类型

修正为：

instance_port=<API_PORT>  # 替换为实际端口数值，无需引号

参数格式错误会导致Eureka注册的实例端口信息异常，直接影响网关调用。

2. 验证机器IP的网络可达性 #

• 从Eureka服务器/网关所在网络，尝试访问http://<MACHINE_IP>:<API_PORT>（比如调用你的FastAPI健康检查接口），确认该地址能正常返回响应。如果无法访问，说明：
  • 你的机器IP在网关所在网络不可达（比如跨网段无路由）
  • 机器防火墙/安全组未开放<API_PORT>端口
• 同时确认Docker容器内能正常访问Eureka服务器，避免容器网络隔离导致注册失败。

3. 检查Eureka实例注册元数据 #

如果能访问Eureka控制台（http://<EUREKA_SERVER_IP>:8070），查看目标实例的以下信息：

• Status是否为UP：如果是DOWN，说明Eureka未检测到服务心跳，检查服务是否正常运行、心跳配置是否正确
• Home Page URL是否为http://<MACHINE_IP>:<API_PORT>/：该URL是网关调用服务的核心地址，若不正确需调整instance_ip和instance_port参数
• Instance ID是否符合预期，避免实例重复注册导致路由混乱

4. 调整py-eureka-client网络配置 #

• 若使用Docker桥接网络，可尝试通过network_interface参数让客户端自动获取容器绑定的主机网卡IP，替代手动指定instance_ip：

  eureka_client.init(
      eureka_server="http://<EUREKA_SERVER_IP>:8070/eureka",
      app_name="<EUREKA_APPNAME>",
      instance_port=<API_PORT>,
      network_interface="eth0"  # 替换为你的主机网卡名称，比如en0、wlan0
  )
  

• 确认instance_ip是网关所在网络能直接访问的公网/内网可路由IP，而非仅本地可访问的回环地址（如127.0.0.1）

5. 核对Docker端口映射配置 #

确保Docker启动命令中的端口映射与注册的instance_port一致：

docker run -p <MACHINE_PORT>:<API_PORT> ...

此处<MACHINE_PORT>必须和instance_port的数值完全相同，否则网关访问<MACHINE_IP>:<API_PORT>时会连接失败。

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