PostgreSQL在Ubuntu上的故障排查步骤是什么

Ubuntu 上 PostgreSQL 故障排查步骤

一 快速定位与通用检查

• 确认服务状态与版本：使用命令查看 PostgreSQL 是否运行、是否启用开机自启，以及实际运行的版本与实例名（如 15-main）。
  示例：sudo systemctl status postgresql、sudo systemctl is-enabled postgresql、pg_lsclusters。
• 查看日志：优先查看 PostgreSQL 集群日志与系统日志，定位启动失败、权限、端口占用等根因。
  示例：sudo tail -n50 /var/log/postgresql/postgresql-15-main.log、sudo journalctl -u postgresql@15-main -b。
• 端口与进程：确认 5432 端口是否被监听、是否被其他进程占用。
  示例：ss -lntp | grep 5432、sudo lsof -iTCP:5432 -sTCP:LISTEN。
• 本地套接字：若本地连接报 “No such file or directory”，检查套接字文件（如 /var/run/postgresql/.s.PGSQL.5432 或 /tmp/.s.PGSQL.5432）是否存在，以及客户端连接时使用的目录是否与服务器配置一致。
• 防火墙与云安全组：确保 UFW/iptables 放行 5432/tcp，以及云上实例的安全组规则允许来源 IP 访问。
  示例：sudo ufw allow 5432/tcp。

二 常见故障与修复对照表

三 远程连接专项排查

• 服务器端配置：
  • postgresql.conf：listen_addresses = '*'（或指定服务器 IP），port = 5432。
  • pg_hba.conf：按需添加规则，例如允许某网段或所有主机使用口令认证：
    • 示例：host all all 192.168.1.0/24 md5 或 host all all 0.0.0.0/0 md5（生产环境请限制来源）。
• 网络与安全：
  • 防火墙放行：sudo ufw allow 5432/tcp；如使用云服务器，同步放通安全组入站规则。
  • 避免仅开放回环地址（127.0.0.1）导致外网无法连接。
• 客户端验证：
  • 从远程主机测试：psql -h <服务器IP> -p 5432 -U <用户> -d <库名>。
  • 若报 “no pg_hba.conf entry …”，说明 pg_hba.conf 未允许该来源；若超时，多为网络/防火墙问题。

四 启动依赖与系统资源问题

• 外置存储或慢速设备导致启动过早失败：
  • 现象：systemctl status 显示 Result: protocol，日志提示数据目录不可访问或 PID 文件无法创建。
  • 处理：为实例添加启动延迟，例如创建 drop-in 配置：
    • sudo mkdir -p /etc/systemd/system/postgresql@15-main.service.d
    • sudo tee /etc/systemd/system/postgresql@15-main.service.d/override.conf <<'EOF'
[Service]
ExecStartPre=/bin/sleep 5
EOF
    • sudo systemctl daemon-reload && sudo reboot
• 信号量不足导致无法启动：
  • 现象：日志出现 “FATAL: could not create semaphores: No space left on device”。
  • 处理：调高内核 kernel.sem（如 sysctl -w kernel.sem="250 32000 100 128"），或减少 max_connections 以降低信号量占用。

五 最小复现与验证清单

• 本地连通性：sudo -u postgres psql -c "select version();"（能连说明服务与本地套接字正常）。
• 远程连通性：psql -h <IP> -p 5432 -U <user> -d postgres（能连说明网络、防火墙、listen_addresses、pg_hba 正常）。
• 端口监听：ss -lntp | grep 5432 应看到 postgres 进程监听 0.0.0.0:5432 或 *:5432。
• 日志干净：最近启动无 FATAL/ERROR，仅见正常启动与连接日志。
• 配置热加载：修改 postgresql.conf/pg_hba.conf 后优先执行 sudo systemctl reload postgresql，减少业务中断。