PostgreSQL启动报错pg_hba.conf配置文件语法错误该如何解决

核心错误为Dockerfile最后一行的启动命令配置错误：错误将pg_hba.conf（客户端认证配置文件）传给了config_file参数，该参数要求传入PostgreSQL主配置文件postgresql.conf，两者语法格式完全不同，PostgreSQL用主配置的语法解析pg_hba文件时自然会触发语法报错。
同时存在三处不必要的冗余配置：

• 无需手动执行RUN initdb，官方postgres镜像会在首次启动时自动完成初始化操作
• 手动指定USER postgres没有必要，镜像默认会使用postgres用户运行服务
• 直接将pg_hba.conf放到/docker-entrypoint-initdb.d目录不会自动生效，该目录仅会自动执行.sql/.sql.gz/.sh后缀的初始化文件

这里提供两种常用的可行方案：

方案1：修改启动参数指定hba配置文件 #

修正后的Dockerfile内容如下：

FROM postgres:latest
ARG VERSION

# 将pg_hba.conf复制到固定配置目录
COPY postgres_init/pg_hba.conf /etc/postgresql/pg_hba.conf

# 启动时用hba_file参数指定自定义的认证配置文件路径
CMD postgres -c hba_file=/etc/postgresql/pg_hba.conf

方案2：利用官方镜像初始化逻辑自动替换配置 #

在postgres_init目录下新建shell脚本init-pg-hba.sh，内容如下：

#!/bin/bash
cp /docker-entrypoint-initdb.d/pg_hba.conf $PGDATA/pg_hba.conf

给该脚本添加可执行权限后，使用如下Dockerfile即可：

FROM postgres:latest
ARG VERSION

COPY postgres_init /docker-entrypoint-initdb.d

该方案无需修改默认启动命令，镜像初始化时会自动执行shell脚本将自定义的pg_hba.conf替换到数据目录的默认位置，后续所有启动都会生效。

修改后如果还有报错可以检查pg_hba.conf的内容：

• 行首不要有多余的不可见字符、全角空格
• 各字段之间使用空白符（空格/制表符）分隔即可，不要使用其他特殊字符

内容的提问来源于stack exchange，提问作者zendevil.eth