使用createdb在PostgreSQL Docker容器建库后报错的原因及原理咨询

1. 为何会出现套接字连接错误？ #

createdb是PostgreSQL的客户端工具，它的默认连接逻辑是：如果没显式指定-h（主机）参数，会优先尝试通过Unix域套接字连接本地的PostgreSQL服务，对应默认套接字路径是/tmp/.s.PGSQL.5432。你本地没运行PostgreSQL服务，这个套接字文件不存在，所以触发了错误提示。

2. 报错情况下数据库仍能创建成功的原因 #

这个错误只是createdb尝试默认本地连接失败的提示，并不会终止整个命令的执行。只要你在命令里指定了正确的连接参数（比如指向Docker容器的主机、端口、用户名），createdb会跳过默认连接失败的环节，转而使用你指定的参数通过TCP连接到Docker容器内的PostgreSQL服务，完成数据库创建。

3. 终端命令如何识别到Docker容器而非本地服务？ #

核心是你指定的连接参数或环境变量在起作用：

• 如果你在命令里加了-h localhost -p 5433这类参数：-h localhost让客户端通过TCP连接到本地主机，-p 5433指定连接的端口。而你的Docker容器启动时做了端口映射（比如docker run -p 5433:5432 ...），把容器内部PostgreSQL的默认5432端口映射到了本地的5433端口。Docker会自动把本地5433端口的TCP请求转发到容器内部的5432端口，从而连接到容器里的PostgreSQL服务。
• 如果你设置了PGHOST、PGPORT这类环境变量（比如export PGHOST=localhost PGPORT=5433），createdb会自动读取这些变量作为连接参数，无需在命令里重复指定。

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