Docker容器内gRPC客户端无法连通宿主机gRPC服务端问题求助

• gRPC客户端地址格式错误：代码中gRPC服务地址被写为http://host.docker.internal，gRPC的channel目标地址不需要带http:///https://协议前缀，带前缀会导致底层地址解析逻辑异常，无法正常建立连接。
• TLS证书域名校验不匹配：本地直连时使用localhost访问，服务端SSL证书的SAN（主体备用名称）通常仅配置localhost、127.0.0.1等本地地址；容器内通过host.docker.internal访问时，TLS握手阶段客户端校验服务端证书，发现访问域名不在证书信任列表中，会直接终止连接，最终抛出RPC Target is unavailable错误。
• 可选排查项：若宿主机为Linux系统，默认Docker不会自动将host.docker.internal映射到宿主机网关，即使域名可解析也可能存在路由不通问题；另外需确认宿主机防火墙没有拦截9090端口的入站请求。

1. 修正客户端gRPC地址格式
   修改grpc_call.py中的地址配置，删除多余的协议前缀：

# 错误写法
# grpcAddress = "http://host.docker.internal"
# 正确写法
grpcAddress = "host.docker.internal"
grpcFull = f"{grpcAddress}:9090"

2. 重新签发服务端SSL证书，补充SAN配置
   重新生成服务端证书时，在证书的主体备用名称列表中添加所有需要用到的访问地址，至少包含：

• localhost
• 127.0.0.1
• host.docker.internal
  如果使用OpenSSL签发证书，可在openssl配置文件中添加如下配置段：

[alt_names]
DNS.1 = localhost
DNS.2 = host.docker.internal
IP.1 = 127.0.0.1

签发完成后替换服务端、客户端certs目录下的对应证书文件，重启Node.js gRPC服务。

3. Linux环境额外配置（仅Linux宿主机需要）
   若Docker运行在Linux系统上，需在docker-compose.yaml中添加extra_hosts配置，手动将host.docker.internal映射到宿主机网关：

version: "3.9"
services:
  test-flask:
    image: me/test-flask
    container_name: test-flask
    restart: "no"
    env_file: .env
    ports:
      - 0.0.0.0:8010:8010
    # 新增以下配置
    extra_hosts:
      - "host.docker.internal:host-gateway"
    command: python3 -m flask run --host=0.0.0.0 --port=8010

4. 连通性验证
   配置完成后，先进入Flask容器执行nc -zv host.docker.internal 9090确认9090端口连通正常，再重启Flask服务即可恢复gRPC调用。

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