从Docker容器连接本地非Docker应用失败，报错gaierror求排查

核心错误点 #

• 环境变量格式错误：你的IBKR_CLIENT_URL_KEY= "host.docker.internal"配置中，等号后多了空格和不必要的引号，导致容器读取到的变量值是"host.docker.internal"（带引号和空格），Python代码解析这个字符串时会触发域名解析失败（gaierror）。

修正后的Docker Compose配置 #

services:
  ibkr-bot-eminisp500:
    container_name: ibkr-bot-eminisp500
    image: |my-image|
    network_mode: host
    environment:
      - IBKR_CLIENT_URL_KEY=host.docker.internal
      - IBKR_PORT_KEY=7497

额外说明 #

• 当设置network_mode: host时，容器直接复用主机网络栈，extra_hosts配置属于冗余项，可以删除；如果需要跨平台兼容性（比如Windows/macOS），保留也不影响，但核心问题还是环境变量的格式错误。
• 额外检查：确保本地应用确实在7497端口监听，且监听地址为0.0.0.0或127.0.0.1（使用host网络时，容器可直接访问主机的localhost）；同时确认Python代码正确读取环境变量，没有额外的字符串处理错误。

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