出现"no pg_hba.conf entry"报错意味着 PostgreSQL 服务器拒绝了当前客户端的连接请求，原因是服务器的宿主认证配置文件未包含该 IP 或用户的允许规则。处理方向是修改服务器端的 pg_hba.conf 文件添加对应网段规则并重载配置，风险边界在于避免随意开放 0.0.0.0/0 导致数据库暴露。

命令速用版

若已确认 IP 地址为 192.168.1.100，认证方式建议使用 scram-sha-256，可在配置文件中添加如下规则：

host    all             all             192.168.1.100/32            scram-sha-256

添加后无需重启服务，执行以下 SQL 或系统命令使配置生效：

SELECT pg_reload_conf();

或在操作系统 shell 中执行：

pg_ctl reload -D /path/to/data

为什么会这样

PostgreSQL 使用 pg_hba.conf 文件控制客户端宿主认证，规则按顺序匹配，一旦匹配失败或未匹配则拒绝连接。

当客户端发起连接时，服务器会检查该文件的每一行，寻找与连接类型、数据库、用户、客户端地址相匹配的条目。如果找到匹配项但认证失败，会报认证错误；如果遍历完文件仍未找到匹配项，则报"no pg_hba.conf entry"错误。这通常是因为新客户端 IP 不在允许的网段内，或者配置文件未包含该用户的远程访问权限。

分步处理

步骤 1：定位配置文件

登录 PostgreSQL 服务器，通过 SQL 查询配置路径：

SHOW hba_file;

常见默认路径包括 /etc/postgresql/版本/main/pg_hba.conf 或数据目录下的 pg_hba.conf。
步骤 2：备份配置文件


修改前务必备份，防止配置错误导致无法连接：
cp pg_hba.conf pg_hba.conf.bak
步骤 3：编辑规则
使用编辑器打开文件，在文件末尾添加新行。格式为：类型 数据库 用户 地址 认证方法。例如允许 192.168.1.0 网段访问：
host    all             all             192.168.1.0/24            scram-sha-256
步骤 4：重载配置
保存文件后，通过 SQL 或系统命令重载配置，无需重启服务。


怎么验证是否生效
在客户端机器上使用 psql 命令尝试连接，观察是否不再报错：
psql -h 服务器 IP -U 用户名 -d 数据库名
若连接成功，说明白名单配置生效。若仍报错，检查服务器日志文件，通常位于 data 目录下的 log 子目录或 /var/log/postgresql/，查看具体的拒绝原因。
常见坑

规则顺序：pg_hba.conf 按从上到下顺序匹配，第一条匹配成功的规则生效。若前面有拒绝规则，后面的允许规则不会生效。
IPv6 问题：若客户端使用 IPv6 连接，需配置 ipv6 地址规则或使用 host 所有地址，否则 IPv4 规则不匹配 IPv6 连接。
认证方法：生产环境避免使用 trust 方法，该方法无需密码即可连接，建议使用 md5 或 scram-sha-256。
重载必要性：修改文件后必须重载配置，直接保存不会立即生效。

常见问题
修改配置后必须重启数据库吗？
不需要重启数据库服务，执行 pg_reload_conf() 或 pg_ctl reload 命令即可使配置生效。
pg_hba.conf 文件在哪里？
可通过 SQL 命令 SHOW hba_file; 查询具体路径，通常在数据目录或 /etc/postgresql 目录下。
trust 和 md5 认证有什么区别？
trust 允许任何匹配该行的用户无需密码直接登录，md5 要求提供密码验证，生产环境严禁使用 trust 开放远程连接。
参考来源

PostgreSQL Documentation, The pg_hba.conf File, https://www.postgresql.org/docs/current/auth-pg-hba-conf.html