解决 Ubuntu 20.04 上因 postmaster.pid 文件残留导致的 PostgreSQL 启动失败问题

解决 Ubuntu 20.04 上因 postmaster.pid 文件残留导致的 PostgreSQL 启动失败问题

在 Ubuntu 20.04 上使用 PostgreSQL 时，如果遇到因为 postmaster.pid 文件未被清理而导致数据库无法启动的问题，这通常是因为系统意外关闭（如突然断电或系统崩溃）导致 PostgreSQL 未能正常关闭。这个问题需要及时解决，以防止服务启动失败和数据访问中断。

问题产生的原因

postmaster.pid 文件位于 PostgreSQL 的数据目录中，用于存储正在运行的 PostgreSQL 服务的主进程 ID（PID）。当 PostgreSQL 正常启动时，它会检查这个文件以确定是否已有一个正在运行的实例。如果 PostgreSQL 非正常终止，这个文件可能不会被自动删除，导致 PostgreSQL 在下次启动时误认为另一个实例仍在运行，从而阻止新的服务实例启动。

解决方案

解决这个问题的步骤需要小心谨慎，以避免数据损坏。

步骤 1: 确认问题

首先，需要确认 PostgreSQL 服务确实因为 postmaster.pid 文件存在而无法启动。

1. 尝试启动 PostgreSQL 服务：

   sudo systemctl start postgresql.service
   

2. 查看服务状态以确认错误原因：

   sudo systemctl status postgresql.service
   

   如果出现错误提示关于 postmaster.pid 文件已存在或类似信息，则需要进行下一步处理。

步骤 2: 检查是否有活跃的 PostgreSQL 进程

在删除 postmaster.pid 文件之前，确保没有 PostgreSQL 进程实际在运行。

1. 检查 PostgreSQL 进程：

   ps -ef | grep postgres
   

2. 如果发现有 PostgreSQL 相关进程在运行，请仔细评估是否应该结束这些进程。如果确定这些进程是僵尸进程，可以使用 kill 命令终止它们：

   sudo kill -9 [PID]
   

   替换 [PID] 为实际的进程 ID。

步骤 3: 删除 postmaster.pid 文件

如果确认没有 PostgreSQL 进程在运行，可以安全删除 postmaster.pid 文件。

1. 导航到 PostgreSQL 数据目录：

   cd /var/lib/postgresql/12/main
   

2. 删除 postmaster.pid 文件：

   sudo rm postmaster.pid
   

步骤 4: 重新启动 PostgreSQL 服务

删除 postmaster.pid 文件后，尝试重新启动 PostgreSQL 服务：

sudo systemctl start postgresql.service

步骤 5: 验证服务状态

确认服务已成功启动并运行：

sudo systemctl status postgresql.service

总结

通过以上步骤，您可以解决因 postmaster.pid 文件残留导致的 PostgreSQL 启动问题。此过程不仅帮助恢复服务，还可以防止未来因类似情况导致的启动问题，确保数据库服务的稳定性和可靠性。