ASP.NET Core WebApi连接Docker部署PostgreSQL数据库失败问题咨询

• localhost的生效范围是当前的网络命名空间：你本地安装的pgAdmin运行在宿主机操作系统的网络栈下，它指向的localhost就是宿主机本身，PostgreSQL容器启动时你已经做了端口映射（将容器的5432端口绑定到宿主机的5432端口），所以pgAdmin使用localhost:5432可以正常访问数据库。
• 当你通过Docker Compose启动ASP.NET Core WebApi时，WebApi服务本身运行在独立的Docker容器中，Docker容器默认拥有独立的网络命名空间，此时WebApi读取的localhost指向的是WebApi自己的容器，而非宿主机，该容器内没有运行PostgreSQL服务，因此触发连接失败的报错：

Npgsql.NpgsqlException: 'Exception while connecting'
Inner Exception
ExtendedSocketException: Cannot assign requested address [::1]:5432

• host.docker.internal是Docker Desktop为Windows、macOS环境默认提供的特殊DNS地址，作用是让容器内部可以直接访问宿主机的网络入口，你将连接字符串的Host改为该值后，WebApi容器会直接访问宿主机上映射的5432端口，就能成功连接到PostgreSQL容器。

额外说明 #

如果后续要将整套服务部署到Linux环境的Docker运行时，默认不会自动生成host.docker.internal的DNS解析，可以在docker-compose.yml中为WebApi服务添加extra_hosts配置手动绑定：

services:
  your-webapi-service-name:
    extra_hosts:
      - "host.docker.internal:host-gateway"

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