你遇到的核心问题是容器内的localhost并非指向宿主机——Docker容器默认有自己独立的网络栈，容器里的localhost指代容器自身，而不是运行Docker的宿主机。所以当你的服务在容器内访问localhost:5432时，它实际上在尝试连接容器内部的5432端口，而不是你用kubectl port-forward转发到宿主机的那个端口。

另外，你的docker-compose.yml里映射5432:5432是多余的，这个配置是把容器的5432端口暴露给宿主机，而不是让容器访问宿主机的5432端口，甚至可能和宿主机上的port-forward端口冲突，建议直接去掉。

下面提供几种可行的解决思路，你可以根据自己的操作系统和需求选择：

1. 使用宿主机的特殊DNS名/IP（推荐） #

针对Mac/Windows的Docker Desktop #

Docker Desktop提供了一个内置的DNS名称host.docker.internal，可以直接用来访问宿主机。修改你的环境变量即可：

version: '3'
services:
  api:
    build: .
    ports:
      - "8000:8000"
    environment:
      - APP_PORT=8000
      - DB_SERVER=host.docker.internal  # 替换原来的localhost
      - DB_PORT=5432
      - DB_USER=postgres
      - DB_PASSWORD=mypassword

针对Linux系统 #

Linux上没有host.docker.internal这个默认DNS，你可以使用Docker网桥的默认IP（通常是172.17.0.1），或者通过ip addr show docker0命令查看具体的网桥IP。修改环境变量：

version: '3'
services:
  api:
    build: .
    ports:
      - "8000:8000"
    environment:
      - APP_PORT=8000
      - DB_SERVER=172.17.0.1  # 替换为你的Docker网桥IP
      - DB_PORT=5432
      - DB_USER=postgres
      - DB_PASSWORD=mypassword

2. 使用Host网络模式（兼容性注意） #

如果你的场景允许，可以让容器直接使用宿主机的网络栈，这样容器内的localhost就和宿主机的localhost一致了。修改docker-compose.yml：

version: '3'
services:
  api:
    build: .
    network_mode: host  # 添加这一行
    environment:
      - APP_PORT=8000
      - DB_SERVER=localhost
      - DB_PORT=5432
      - DB_USER=postgres
      - DB_PASSWORD=mypassword

注意：这种方式在Mac/Windows的Docker Desktop上支持有限，因为Docker Desktop是运行在虚拟机里的，host模式实际指向虚拟机的网络，可能需要额外配置；Linux系统下可以正常使用。同时使用host网络后，ports配置会失效，因为容器直接使用宿主机端口。

3. 调整port-forward的绑定地址 #

默认情况下，kubectl port-forward只绑定127.0.0.1，只有宿主机本地能访问。如果要让容器也能访问，需要把绑定地址改成0.0.0.0，允许所有接口访问：

kubectl port-forward --address 0.0.0.0 <你的数据库Pod名称> 5432:5432

这个操作需要配合前面的第一种方案（使用宿主机IP/DNS）一起使用，因为即使port-forward允许外部访问，容器还是需要通过宿主机的IP来连接。

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