Docker容器中发起HttpRequest后出现地址不可用问题

问题原因 #

当你的.NET Minimal API部署到Docker容器后，代码里如果仍用localhost:8080请求Keycloak会失败。因为容器内的localhost指向容器自身，而非宿主机或Keycloak容器，所以会抛出Address not available (localhost:8080)错误。

解决方案 #

1. 用Docker容器名称替换localhost作为请求地址 #

如果两个容器处于同一Docker网络（自定义网络或默认bridge网络），直接把请求地址里的localhost换成Keycloak的容器名称（比如启动Keycloak时用--name keycloak，就写keycloak）。

示例修改后的请求地址：

http://keycloak:8080/realms/your-realm/protocol/openid-connect/token

2. 创建并使用自定义Docker网络（推荐） #

默认bridge网络可能存在解析不稳定的情况，自定义网络更可靠：

• 创建自定义网络：

  docker network create app-network
  

• 启动Keycloak时加入该网络：

  docker run -d --name keycloak --network app-network -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin quay.io/keycloak/keycloak:latest start-dev
  

• 启动你的.NET API容器时加入同一网络：

  docker run -d --name my-api --network app-network -p 5000:80 your-api-image
  

3. 检查Keycloak客户端配置 #

确保Keycloak允许API容器的访问：

• 进入Keycloak管理控制台，找到对应Realm和客户端
• 在Web Origins中添加*（开发环境）或API容器的网络地址（生产环境）
• 确认Valid Redirect URIs配置匹配你的API需求

你的Dockerfile无需修改 #

当前的Dockerfile是标准的.NET 7 Alpine构建流程，问题出在容器网络通信和请求地址配置上，不需要调整镜像构建逻辑。

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