问题：如何解决 psql 连接本地 PostgreSQL 服务器失败问题？

Question

**问题描述：如何解决 psql 连接本地 PostgreSQL 服务器失败问题？** 在使用 `psql` 连接本地 PostgreSQL 数据库时，常常会遇到连接失败的问题。常见的错误提示包括 `psql: could not connect to server` 或 `Connection refused`。这类问题通常由 PostgreSQL 服务未启动、监听地址配置错误、端口被占用或防火墙限制等原因造成。本文将围绕这些常见问题，深入分析 `psql` 连接本地 PostgreSQL 失败的典型场景，并提供相应的排查步骤与解决方案，帮助开发者快速定位并修复连接问题，确保数据库服务正常运行。

Answer 1

一、问题现象与初步判断

在使用 psql 连接本地 PostgreSQL 服务器时，最常见的错误提示包括：

• psql: could not connect to server: Connection refused
• psql: could not connect to server: No such file or directory
• Is the server running locally and accepting connections on Unix domain socket

这些错误通常意味着 PostgreSQL 服务未启动、监听配置错误、端口被占用或权限问题。

二、排查步骤与解决方案

1. 检查 PostgreSQL 服务是否运行

首先确认 PostgreSQL 是否正在运行。在大多数 Linux 系统中，可以使用以下命令：

systemctl status postgresql

如果服务未运行，可以使用以下命令启动：

sudo systemctl start postgresql

如果系统使用的是旧版 init 系统，可尝试：

sudo service postgresql start

2. 检查监听地址与端口配置

PostgreSQL 默认监听在 localhost（127.0.0.1）和 Unix 域套接字。可以通过编辑 postgresql.conf 文件调整监听地址：

listen_addresses = 'localhost'

如果需要远程连接，可以设置为：

listen_addresses = '*'

同时，检查端口是否为默认 5432 或其他自定义端口：

port = 5432

修改后重启服务：

sudo systemctl restart postgresql

3. 检查端口占用情况

使用 netstat 或 ss 命令检查端口是否被其他进程占用：

sudo netstat -tulnp | grep 5432

sudo ss -tulnp | grep 5432

若发现端口被占用，可使用 kill 命令终止进程（谨慎操作）：

sudo kill -9 <PID>

4. 检查防火墙设置

在某些系统中，防火墙可能阻止了本地连接。可以临时关闭防火墙进行测试：

sudo ufw disable

或放行 PostgreSQL 端口：

sudo ufw allow 5432/tcp

在 CentOS/RHEL 系统中：

sudo firewall-cmd --permanent --add-port=5432/tcp

sudo firewall-cmd --reload

5. 检查客户端连接方式

PostgreSQL 支持通过 Unix 套接字或 TCP/IP 连接。使用 psql 时默认使用 Unix 套接字。如果想强制使用 TCP/IP，可使用：

psql -h localhost -U postgres

若使用 Unix 套接字，确认套接字路径是否正确：

unix_socket_directories = '/var/run/postgresql'

6. 检查 pg_hba.conf 认证配置

文件 pg_hba.conf 控制客户端认证方式。例如：

类型	数据库	用户	地址	方法
local	all	all		peer
host	all	all	127.0.0.1/32	trust

修改后需重载配置：

sudo pg_ctlcluster <version> main reload

三、流程图：连接失败排查流程

      graph TD
      A[尝试连接] --> B{服务是否运行?}
      B -->|否| C[启动 PostgreSQL 服务]
      B -->|是| D{监听地址是否正确?}
      D -->|否| E[修改 listen_addresses]
      D -->|是| F{端口是否被占用?}
      F -->|是| G[终止占用进程]
      F -->|否| H{防火墙是否允许端口?}
      H -->|否| I[放行 5432 端口]
      H -->|是| J{认证方式是否正确?}
      J -->|否| K[修改 pg_hba.conf]
      J -->|是| L[连接成功]
    

四、总结与建议

PostgreSQL 连接失败问题涉及多个层面，从服务状态到网络配置、防火墙、认证机制等。建议开发者在排查时按步骤逐层检查，优先确认服务是否运行，再逐步深入配置文件与网络环境。