迁移至Apple Silicon Mac后Docker Postgres连接配置问题

你遇到的连接故障和Apple Silicon的转译机制无关，核心原因是跨架构迁移后旧容器的端口映射规则失效，且你测试的所有HOST地址均不适用于宿主机直连Docker容器的场景。

为什么你试的所有HOST都不对 #

• 容器名my_database_server：仅同一Docker自定义网络内的容器之间可以通过容器名互相解析，你的NestJS项目运行在宿主机，不在Docker网络内，无法解析该地址
• 192.168.65.0/24是Docker的子网网段标识，不是可访问的服务IP，必然报解析错误
• 容器内网IP172.17.0.2、子网地址192.168.65.0：Docker Desktop在MacOS上运行在独立轻量虚拟机内，这类内网IP仅对虚拟机内部生效，宿主机没有对应路由，必然连接超时
• 所谓host.docker.internal是专门给容器内部访问宿主机服务用的地址，宿主机访问容器不需要用这个地址

修复步骤 #

1. 先验证端口映射状态，在宿主机终端执行：

   lsof -i :5432
   

   如果返回结果里没有Docker相关进程监听5432端口，就说明你现在的旧容器端口映射完全没生效——这是M系列芯片Mac迁移x86架构Docker容器的常见问题，旧容器的网络规则不会在arm版Docker Desktop上自动重建。
2. 用你原来的shell脚本重新创建容器即可，脚本本身不需要修改，-p 5432:5432参数已经正确把容器5432端口映射到宿主机的127.0.0.1:5432上。

   注意：你当前的脚本每次执行都会删除旧容器，没有配置数据卷持久化，如果需要保留原有数据，先通过docker exec命令把库数据导出后再重建容器，避免数据丢失。

3. 重建完成后再次执行lsof -i :5432，确认Docker进程正在监听5432端口。

最终可用的.env配置 #

直接沿用你最初的配置即可，不需要修改HOST地址：

POSTGRES_HOST=127.0.0.1
POSTGRES_PORT=5432
POSTGRES_USER=postgres
POSTGRES_PASSWORD=mysecretpassword
POSTGRES_DATABASE=my_database

备用排查项 #

如果重建容器后依然无法连接，检查两个配置：

• 打开Docker Desktop设置-开发中功能项，确认开启Use the new Virtualization framework和Enable VirtioFS accelerated directory sharing，重启Docker后再重建容器
• 检查宿主机是否有本地安装的Postgres或其他服务占用5432端口，如果有冲突，要么停掉占用端口的服务，要么把docker run的端口映射改为-p 5433:5432，对应把.env里的POSTGRES_PORT改为5433即可

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