Linux pgAdmin故障排查步驟

以下是Linux下pgAdmin的故障排查步驟：

1. 檢查服務狀態

   • 確保PostgreSQL服務運行：sudo systemctl status postgresql，未運行則啟動：sudo systemctl start postgresql。
   • 檢查pgAdmin服務狀態（若為服務模式）：sudo systemctl status pgadmin4。

2. 查看日志文件

   • pgAdmin日志：通常位于/var/log/pgadmin/或~/.pgadmin/，使用tail -f實時查看。
   • PostgreSQL日志：位于/var/log/postgresql/，排查連接或服務異常。

3. 驗證配置文件

   • 檢查pgadmin4.conf（路徑：/etc/pgadmin4/或~/.pgadmin/），確認listen_addresses包含正確IP（如0.0.0.0）。
   • 確保pg_hba.conf允許遠程連接（添加host all all 0.0.0.0/0 md5），修改后重啟PostgreSQL。

4. 排查網絡與防火墻

   • 檢查防火墻規則，放行PostgreSQL默認端口（5432）：
     sudo ufw allow 5432/tcp（Ubuntu）或sudo firewall-cmd --add-port=5432/tcp --permanent（CentOS）。
   • 使用ping或telnet測試網絡連通性。

5. 確認權限與版本兼容性

   • 確保pgAdmin用戶有數據庫訪問權限，檢查pg_hba.conf中用戶認證方式。
   • 確認pgAdmin與PostgreSQL版本兼容，必要時升級/降級軟件。

6. 嘗試基礎操作

   • 重啟PostgreSQL和pgAdmin服務：sudo systemctl restart postgresql pgadmin4。
   • 若配置錯誤，刪除配置文件后重新啟動（如~/.pgadmin目錄）。

7. 參考官方資源

   • 查閱pgAdmin官方文檔或社區論壇，獲取特定錯誤代碼的解決方案。

注：不同Linux發行版（如Ubuntu/CentOS）的路徑和命令可能略有差異，需根據實際系統調整。