ASP.NET Core 6在WSL2 Docker容器中无法解析PostgreSQL主机名

核心问题分析 #

1. 连接字符串端口错误：容器间通信需使用PostgreSQL的内部端口5432，主机映射的5433仅用于外部（Windows主机）访问。
2. Docker运行参数顺序错误：--network等选项需放在镜像名之前，否则会被当作容器内执行的命令参数，导致应用容器未正确加入目标网络。
3. 默认bridge网络的DNS限制：默认bridge网络的容器名解析支持有限，自定义网络更可靠。

解决方案步骤 #

1. 修正容器内应用的连接字符串

将连接字符串中的端口从5433改为PostgreSQL容器的内部端口5432：

Host=postgres:5432; Database=foo-next-docker; Username=postgres; Password=postgres; Timeout=300; CommandTimeout=300

2. 修复应用容器的启动命令参数顺序

Docker命令结构为docker run [OPTIONS] IMAGE [COMMAND]，所有运行选项（如--network）必须放在镜像名之前。正确的启动命令：

docker run -p 8080:80 --name fooapp --network=bridge fooapp

执行后重新检查应用容器网络状态，应能看到完整的网络属性（非空的EndpointID、IPAddress等）：

docker inspect fooapp -f "{{json .NetworkSettings.Networks }}"

3. 推荐使用自定义Docker网络（更稳定）

自定义网络自动支持容器名到IP的DNS解析，无需额外配置：

• 创建自定义网络：

  docker network create app-network
  

• 重启PostgreSQL容器并加入自定义网络：

  docker stop postgres
  docker rm postgres
  docker run -d -v pgdata:/var/lib/postgresql/data -e POSTGRES_PASSWORD=postgres -p 5433:5432 --name postgres --network=app-network postgres
  

• 启动应用容器并加入同一网络：

  docker run -p 8080:80 --name fooapp --network=app-network fooapp
  

额外检查项 #

• 确认PostgreSQL容器的名称为postgres（可通过docker ps查看），若容器名不同，连接字符串中的主机名需对应修改。
• 若仍存在网络异常，可重启Rancher Desktop或WSL2实例（执行wsl --shutdown后重新启动）修复网络栈问题。

内容的提问来源于stack exchange，提问作者Alexei - check Codidact