PostgreSQL笔记11:安装部署阶段常见问题排查与解决方案

pgsql简介 1、pg和mysql的优劣势2、yum下载安装2.1、启动初始化3、源码编译安装4、pg_ctl管理工具4.1、创建新的数据库,多实例5、常用选项5.1、psql6、配置postgresql6.1、配置文件6.1.1、开启远程登录6.2pg_hba.conf文件6.2.1、文件格式6.2.2、远程连接免密登录6.3、数据的组织结构6.4、创建数据库6.5、删除数据库6.6、数据库文件路径6.7、创建schema模式分类7、管理表7.1、函数7.2、增删改查7.2.1、增加insert。 阅读详情

纲要

  • PostgreSQL 数据目录权限要求(0700)
  • PostgreSQL 端口占用问题(port、5432)
  • PostgreSQL 监听地址与连接拒绝(listen_addresses、localhost、Unix-domain socket)
  • PostgreSQL 内存不足问题(shared_buffers、max_connections、System V shared memory)
  • PostgreSQL 系统表索引损坏与恢复(ignore_system_indexes、REINDEX、pg_class)
  • 插件文件缺失与数据库坏块
  • 日志排查方法论(启动日志、CSV 日志、操作系统日志)

目录权限:数据目录必须为 0700

PostgreSQL 对数据目录的权限有严格要求。当数据目录的权限过于宽松(例如 0755 或 0777)时,启动时会报错:

FATAL: data directory "/path/to/data" has group or world access
DETAIL: Permissions should be u=rwx (0700)

该检查机制是为了防止其他用户读取数据库的敏感文件,包括 postgresql.conf、pg_hba.conf、日志文件以及表数据文件。PostgreSQL 要求数据目录的属主必须为数据库运行用户(通常为 postgres),且权限必须为 0700。

解决方案

# 确认当前数据目录的属主和权限
ls -ld $PGDATA

# 修正属主(如需要)
chown -R postgres:postgres $PGDATA

# 修正权限为 0700
chmod 0700 $PGDATA

PostgreSQL 11 及以上版本还支持 0750(即 u=rwx,g=rx),但前提是使用了 --allow-group-access 选项进行初始化。生产环境建议统一使用 0700。

端口占用:Address already in use

PostgreSQL 默认监听端口为 5432。当该端口已被其他进程占用时,启动失败并报错:

LOG: could not bind IPv4 address "0.0.0.0": Address already in use
HINT: Is another postmaster already running on port 5432? If not, wait a few seconds and retry.

该错误的常见原因包括:

  • 另一个 PostgreSQL 实例已在运行
  • 其他非 PostgreSQL 进程占用了该端口
  • 终止 PostgreSQL 后立即重启,操作系统尚未释放端口

排查与解决

# 查看端口占用情况(推荐使用 ss)
ss -lntp | grep 5432

# 或使用 netstat
netstat -tulpn | grep 5432

# 确认占用进程后,可停止该进程或修改端口

同一台主机上可以运行多个 PostgreSQL 实例,只需为每个实例配置不同的端口即可。修改 postgresql.conf 中的 port 参数:

# postgresql.conf
port = 5433

修改端口后需要重启数据库服务。

监听地址与连接拒绝:listen_addresses

默认情况下,PostgreSQL 仅监听 localhost(127.0.0.1),即仅允许本地回环地址的连接。这意味着通过 TCP/IP 从其他主机或使用 -h 指定 IP 地址连接时,会收到连接拒绝错误:

psql: error: connection to server at "192.168.1.100", port 5432 failed: Connection refused
Is the server running on that host and accepting TCP/IP connections?

这是由于 listen_addresses 参数仅设置为 localhost,PostgreSQL 没有在指定的 IP 接口上监听。listen_addresses 参数只能在服务器启动时设置,修改后必须重启。

解决方案

# postgresql.conf
listen_addresses = '*'          # 监听所有可用 IP 接口
# 或指定具体 IP
listen_addresses = '0.0.0.0'    # 监听所有 IPv4 地址
# 或
listen_addresses = '192.168.1.100,localhost'

修改后重启 PostgreSQL:

pg_ctl restart -D $PGDATA

验证监听状态:

ss -lntp | grep postgres
# 或
netstat -tulpn | grep postgres

需要注意的是,listen_addresses 控制的是服务器监听的网络接口,而 pg_hba.conf 控制的是客户端认证。两者需配合使用,仅修改 listen_addresses 而不配置 pg_hba.conf 仍可能导致连接失败。

内存不足:shared_buffers 与 max_connections

PostgreSQL 使用 System V 共享内存(或 mmap)进行进程间通信。shared_buffers 参数控制数据库服务器用于共享内存缓冲区的内存量。当 shared_buffers 设置值超过系统可用内存时,启动时会报错:

FATAL: could not map anonymous shared memory: Cannot allocate memory
HINT: This error usually means that PostgreSQL's request for a shared memory segment exceeded available memory, swap space, or huge pages. To reduce the request size, reduce PostgreSQL's shared memory usage, perhaps by reducing "shared_buffers" or "max_connections".

该错误的核心原因是 PostgreSQL 请求的共享内存段超出了系统可用内存、交换空间或大页内存的限制。

配置建议

根据官方文档推荐:

  • 对于专用的数据库服务器(内存 ≥ 1GB),shared_buffers 的合理起始值为系统内存的 25%
  • 超过 40% 的分配通常不会带来更好的性能
  • 内存小于 1GB 的系统应使用更小的比例,为操作系统预留足够空间

max_connections 参数也会影响共享内存的分配。每个连接作为一个独立进程,会占用一定的内存资源。增大 max_connections 会导致共享内存分配增加。

排查步骤

# 查看系统内存总量
free -h

# 查看当前 shared_buffers 设置
psql -c "SHOW shared_buffers;"

# 查看当前 max_connections 设置
psql -c "SHOW max_connections;"

# 查看 PostgreSQL 进程内存占用
top -u postgres
# 或
ps aux | grep postgres

系统表索引损坏与恢复

PostgreSQL 在启动时需要读取系统表(如 pg_class)的索引来完成数据库对象的加载。pg_class 是 PostgreSQL 中最重要的系统表之一,所有数据库对象在其中都有记录。如果系统表索引的底层数据文件损坏(例如因磁盘坏块、突然断电等),数据库将无法正常启动。

模拟损坏场景

以下示例演示了如何定位并人为损坏系统表索引的底层文件(仅用于学习目的,切勿在生产环境执行):

-- 查询 pg_class_oid_index 的 OID
SELECT oid, relname FROM pg_class WHERE relname = 'pg_class_oid_index';
-- 假设返回 oid = 34352
# 获取索引对应的物理文件路径
# PGDATA/base/<数据库OID>/<索引OID>
# 使用 dd 人为损坏该文件(危险操作,仅演示)
dd if=/dev/zero of=$PGDATA/base/5/34352 bs=8192 count=1 conv=notrunc

损坏后尝试启动或连接:

psql: error: connection to server on socket "/tmp/.s.PGSQL.5432" failed: FATAL:  invalid page in block 0 of relation base/5/34352

恢复方法:ignore_system_indexes

PostgreSQL 提供了一个开发者选项 ignore_system_indexes,用于在系统索引损坏时临时绕过索引读取。该参数只能在服务器启动时设置,不能在会话开始后修改。

# 以忽略系统索引的方式启动
pg_ctl start -D $PGDATA -o "-c ignore_system_indexes=on"

启动成功后,连接数据库并重建损坏的索引:

-- 重建损坏的系统索引
REINDEX INDEX pg_class_oid_index;

-- 或重建所有系统索引
REINDEX SYSTEM postgres;

重建完成后,关闭数据库并以正常模式重启:

pg_ctl stop -D $PGDATA
pg_ctl start -D $PGDATA

注意事项

  • ignore_system_indexes 属于开发者选项,位于 Developer Options 章节,不应在生产环境中常规使用
  • 该参数设置为 on 时,读取系统表会走顺序扫描而非索引扫描,性能会显著下降
  • 修改系统表索引时,索引仍会被更新,因此使用该参数是安全的

其他常见问题

插件动态库文件缺失

PostgreSQL 通过扩展(插件)实现诸多功能。如果在 shared_preload_libraries 或 local_preload_libraries 中指定了未安装的插件,启动时会报错找不到对应的 .so 文件。解决方案是安装对应的扩展包,或从配置中移除该条目。

数据库坏块

磁盘坏块可能导致数据文件损坏。排查方式包括检查 PostgreSQL 启动日志和操作系统日志。

日志排查方法论

面对启动失败或连接异常,第一原则是查看日志。

日志位置

  • PostgreSQL 启动日志:默认位于 $PGDATA/log/ 目录,或由 log_directory 参数指定
  • PostgreSQL CSV 日志:如启用了 log_destination = 'csvlog',日志文件为 postgresql-*.csv
  • 操作系统日志:
    # 查看内核日志
    dmesg -T | tail -50
    
    # 查看系统日志
    tail -100 /var/log/messages
    # 或
    journalctl -xe | tail -50
    

排查流程

是

否

是

否

启动/连接失败

查看 PostgreSQL 启动日志

日志中有明确报错?

根据报错信息定位问题

查看操作系统日志

是否有磁盘/内存相关错误?

检查磁盘健康状态、内存

检查环境变量、配置文件语法

应用对应解决方案

重启验证

API 速览

本节梳理本文涉及的核心 PostgreSQL 配置参数与管理命令。

配置参数

参数类型默认值说明适用版本
portinteger5432服务器监听的 TCP 端口所有版本
listen_addressesstringlocalhost服务器监听的 TCP/IP 地址列表所有版本
shared_buffersinteger128MB共享内存缓冲区大小所有版本
max_connectionsinteger100最大并发连接数所有版本
ignore_system_indexesbooleanoff读取系统表时忽略系统索引所有版本

管理命令

pg_ctl

# 启动数据库
pg_ctl start -D $PGDATA

# 停止数据库
pg_ctl stop -D $PGDATA

# 重启数据库
pg_ctl restart -D $PGDATA

# 查看数据库状态
pg_ctl status -D $PGDATA

# 带参数启动(如忽略系统索引)
pg_ctl start -D $PGDATA -o "-c ignore_system_indexes=on"

psql

# 连接数据库(默认通过 Unix-domain socket)
psql -d postgres

# 通过 TCP/IP 连接
psql -h 127.0.0.1 -p 5432 -d postgres -U postgres

# 查看配置参数
psql -c "SHOW listen_addresses;"
psql -c "SHOW shared_buffers;"

系统工具

# 查看端口占用
ss -lntp | grep 5432
# 或
netstat -tulpn | grep 5432

# 查看进程
ps aux | grep postgres

# 查看内存
free -h

# 查看磁盘
df -h

Demo 简单示例

运行说明

以下 Demo 演示了一个完整的 PostgreSQL 实例启动、配置修改与故障模拟流程。使用 Node.js + node-postgres(pg 库)进行数据库操作。

环境要求:

  • PostgreSQL 12 及以上版本
  • Node.js 16 及以上版本
  • 已初始化的 PostgreSQL 数据目录

安装依赖:

npm init -y
npm install pg

代码说明

import { Client } from 'pg';
import { exec } from 'child_process';
import { promisify } from 'util';
import * as fs from 'fs';
import * as path from 'path';

const execAsync = promisify(exec);

// PostgreSQL 连接配置
const config = {
  host: 'localhost',
  port: 5432,
  database: 'postgres',
  user: 'postgres',
  password: 'postgres',
};

// PGDATA 路径(请根据实际环境修改)
const PGDATA = '/var/lib/pgsql/data';

/**
 * 1. 测试数据库连接
 */
async function testConnection(): Promise<boolean> {
  const client = new Client(config);
  try {
    await client.connect();
    const res = await client.query('SELECT version()');
    console.log('✅ 连接成功:', res.rows[0].version);
    await client.end();
    return true;
  } catch (err) {
    console.error('❌ 连接失败:', (err as Error).message);
    return false;
  }
}

/**
 * 2. 查看当前配置参数
 */
async function showConfig(param: string): Promise<string> {
  const client = new Client(config);
  try {
    await client.connect();
    const res = await client.query(`SHOW ${param}`);
    await client.end();
    return res.rows[0][param];
  } catch (err) {
    console.error(`❌ 获取参数 ${param} 失败:`, (err as Error).message);
    return '';
  }
}

/**
 * 3. 修改 postgresql.conf 中的配置
 * @param key 配置键名
 * @param value 配置值
 */
async function updateConfig(key: string, value: string): Promise<void> {
  const confPath = path.join(PGDATA, 'postgresql.conf');
  let content = fs.readFileSync(confPath, 'utf-8');
  
  // 替换或添加配置项
  const regex = new RegExp(`^${key}\\s*=\\s*.*$`, 'm');
  const newLine = `${key} = ${value}`;
  
  if (regex.test(content)) {
    content = content.replace(regex, newLine);
  } else {
    content += `\n${newLine}`;
  }
  
  fs.writeFileSync(confPath, content, 'utf-8');
  console.log(`✅ 已更新配置: ${key} = ${value}`);
}

/**
 * 4. 重启 PostgreSQL
 */
async function restartPostgres(): Promise<void> {
  console.log('🔄 正在重启 PostgreSQL...');
  try {
    await execAsync(`pg_ctl restart -D ${PGDATA} -w -t 30`);
    console.log('✅ PostgreSQL 重启成功');
  } catch (err) {
    console.error('❌ 重启失败:', (err as Error).message);
    throw err;
  }
}

/**
 * 5. 主流程:演示端口修改与验证
 */
async function main() {
  console.log('=== PostgreSQL 安装部署问题排查 Demo ===\n');
  
  // Step 1: 测试当前连接
  console.log('【步骤 1】测试当前连接');
  const connected = await testConnection();
  if (!connected) {
    console.log('⚠️ 当前无法连接,请检查 PostgreSQL 是否正常运行\n');
    return;
  }
  
  // Step 2: 查看当前端口
  console.log('\n【步骤 2】查看当前端口配置');
  const currentPort = await showConfig('port');
  console.log(`当前端口: ${currentPort}`);
  
  // Step 3: 修改端口(模拟端口冲突场景)
  console.log('\n【步骤 3】修改端口为 5433');
  await updateConfig('port', '5433');
  await restartPostgres();
  
  // Step 4: 使用新端口连接
  console.log('\n【步骤 4】使用新端口 5433 连接');
  const newConfig = { ...config, port: 5433 };
  const newClient = new Client(newConfig);
  try {
    await newClient.connect();
    const res = await newClient.query('SELECT port FROM pg_settings WHERE name = $1', ['port']);
    console.log(`✅ 新端口连接成功,当前端口: ${res.rows[0].port}`);
    await newClient.end();
  } catch (err) {
    console.error('❌ 新端口连接失败:', (err as Error).message);
  }
  
  // Step 5: 恢复端口
  console.log('\n【步骤 5】恢复端口为 5432');
  await updateConfig('port', '5432');
  await restartPostgres();
  
  console.log('\n✅ Demo 执行完成');
}

main().catch(console.error);

对应的 PostgreSQL 原生指令注释:

-- 查看当前端口
SHOW port;

-- 修改端口(需修改 postgresql.conf)
-- port = 5433

-- 重启数据库
-- pg_ctl restart -D /var/lib/pgsql/data

-- 使用新端口连接
-- psql -p 5433 -d postgres -U postgres

技术点总结

该 Demo 演示了以下核心技术:

  1. Node.js 连接 PostgreSQL:使用 pg 库通过 TCP/IP 连接数据库
  2. 配置参数查询:通过 SHOW 命令获取运行时配置
  3. 配置文件修改:程序化修改 postgresql.conf 中的 port 参数
  4. 服务管理:通过 pg_ctl 命令重启数据库服务
  5. 端口变更验证:修改端口后使用新端口建立连接

多语言 Demo 示例

本部分基于 Node.js 示例,提供 Go、Python、Java 三种语言的完整实现。所有示例均演示了修改 postgresql.conf 中的 port 参数、重启 PostgreSQL 并验证新端口连接的能力。运行前请确保 PGDATA 环境变量指向正确的数据目录,且 pg_ctl 命令可用。

Go 版本

运行说明
  • 环境:Go 1.18+,已安装 lib/pq 驱动
  • 安装依赖:go get github.com/lib/pq
  • 执行:go run demo.go
代码
package main

import (
    "database/sql"
    "fmt"
    "os"
    "os/exec"
    "strings"
    "time"

    _ "github.com/lib/pq"
)

const (
    host     = "localhost"
    port     = 5432
    user     = "postgres"
    password = "postgres"
    dbname   = "postgres"
)

// 获取 PGDATA 环境变量,若未设置则使用默认路径
func getPgData() string {
    pgdata := os.Getenv("PGDATA")
    if pgdata == "" {
        pgdata = "/var/lib/pgsql/data"
    }
    return pgdata
}

// 测试连接
func testConnection(p int) error {
    connStr := fmt.Sprintf("host=%s port=%d user=%s password=%s dbname=%s sslmode=disable",
        host, p, user, password, dbname)
    db, err := sql.Open("postgres", connStr)
    if err != nil {
        return err
    }
    defer db.Close()
    // 设置超时
    db.SetConnMaxLifetime(5 * time.Second)
    if err := db.Ping(); err != nil {
        return err
    }
    var version string
    err = db.QueryRow("SELECT version()").Scan(&version)
    if err != nil {
        return err
    }
    fmt.Println("✅ 连接成功:", version)
    return nil
}

// 查看当前端口配置
func showPort(p int) (string, error) {
    connStr := fmt.Sprintf("host=%s port=%d user=%s password=%s dbname=%s sslmode=disable",
        host, p, user, password, dbname)
    db, err := sql.Open("postgres", connStr)
    if err != nil {
        return "", err
    }
    defer db.Close()
    var portVal string
    err = db.QueryRow("SHOW port").Scan(&portVal)
    if err != nil {
        return "", err
    }
    return portVal, nil
}

// 修改 postgresql.conf 中的端口
func updateConfig(pgdata, key, value string) error {
    confPath := pgdata + "/postgresql.conf"
    content, err := os.ReadFile(confPath)
    if err != nil {
        return err
    }
    lines := strings.Split(string(content), "\n")
    found := false
    for i, line := range lines {
        if strings.HasPrefix(strings.TrimSpace(line), key+" =") {
            lines[i] = key + " = " + value
            found = true
            break
        }
    }
    if !found {
        lines = append(lines, key+" = "+value)
    }
    newContent := strings.Join(lines, "\n")
    err = os.WriteFile(confPath, []byte(newContent), 0644)
    if err != nil {
        return err
    }
    fmt.Printf("✅ 已更新配置: %s = %s\n", key, value)
    return nil
}

// 重启 PostgreSQL
func restartPostgres(pgdata string) error {
    fmt.Println("🔄 正在重启 PostgreSQL...")
    cmd := exec.Command("pg_ctl", "restart", "-D", pgdata, "-w", "-t", "30")
    output, err := cmd.CombinedOutput()
    if err != nil {
        return fmt.Errorf("重启失败: %v, 输出: %s", err, output)
    }
    fmt.Println("✅ PostgreSQL 重启成功")
    return nil
}

func main() {
    pgdata := getPgData()
    fmt.Println("=== PostgreSQL 安装部署问题排查 Demo (Go) ===\n")

    // 步骤1: 测试当前连接
    fmt.Println("【步骤 1】测试当前连接")
    if err := testConnection(port); err != nil {
        fmt.Println("⚠️ 当前无法连接,请检查 PostgreSQL 是否正常运行")
        return
    }

    // 步骤2: 查看当前端口
    fmt.Println("\n【步骤 2】查看当前端口配置")
    curPort, err := showPort(port)
    if err != nil {
        fmt.Println("❌ 获取端口失败:", err)
        return
    }
    fmt.Printf("当前端口: %s\n", curPort)

    // 步骤3: 修改端口为 5433
    fmt.Println("\n【步骤 3】修改端口为 5433")
    if err := updateConfig(pgdata, "port", "5433"); err != nil {
        fmt.Println("❌ 修改配置失败:", err)
        return
    }
    if err := restartPostgres(pgdata); err != nil {
        fmt.Println("❌", err)
        return
    }

    // 步骤4: 使用新端口连接
    fmt.Println("\n【步骤 4】使用新端口 5433 连接")
    if err := testConnection(5433); err != nil {
        fmt.Println("❌ 新端口连接失败:", err)
    } else {
        // 查询当前端口
        newPort, _ := showPort(5433)
        fmt.Printf("当前端口: %s\n", newPort)
    }

    // 步骤5: 恢复端口
    fmt.Println("\n【步骤 5】恢复端口为 5432")
    if err := updateConfig(pgdata, "port", "5432"); err != nil {
        fmt.Println("❌ 修改配置失败:", err)
        return
    }
    if err := restartPostgres(pgdata); err != nil {
        fmt.Println("❌", err)
        return
    }

    fmt.Println("\n✅ Demo 执行完成")
}

对应的 PostgreSQL 原生指令注释:

-- 查看当前端口
SHOW port;

-- 修改端口(需修改 postgresql.conf)
-- port = 5433

-- 重启数据库
-- pg_ctl restart -D /var/lib/pgsql/data

-- 使用新端口连接
-- psql -p 5433 -d postgres -U postgres
技术点总结
  • 使用 lib/pq 驱动连接 PostgreSQL
  • 通过 sql.DB 执行 SHOW 查询
  • 文件读写修改配置文件
  • 调用外部命令 pg_ctl 重启服务
  • 错误处理与超时设置

Python 版本

运行说明
  • 环境:Python 3.8+,已安装 psycopg2 和 python-dotenv(可选)
  • 安装依赖:pip install psycopg2-binary
  • 执行:python demo.py
代码
#!/usr/bin/env python3
import os
import subprocess
import sys
import psycopg2
from psycopg2 import sql

HOST = 'localhost'
PORT = 5432
USER = 'postgres'
PASSWORD = 'postgres'
DBNAME = 'postgres'

def get_pgdata():
    pgdata = os.environ.get('PGDATA')
    if not pgdata:
        pgdata = '/var/lib/pgsql/data'
    return pgdata

def test_connection(port):
    try:
        conn = psycopg2.connect(
            host=HOST,
            port=port,
            user=USER,
            password=PASSWORD,
            dbname=DBNAME,
            connect_timeout=5
        )
        cur = conn.cursor()
        cur.execute("SELECT version()")
        version = cur.fetchone()[0]
        cur.close()
        conn.close()
        print(f"✅ 连接成功: {version}")
        return True
    except Exception as e:
        print(f"❌ 连接失败: {e}")
        return False

def show_port(port):
    try:
        conn = psycopg2.connect(
            host=HOST,
            port=port,
            user=USER,
            password=PASSWORD,
            dbname=DBNAME,
            connect_timeout=5
        )
        cur = conn.cursor()
        cur.execute("SHOW port")
        port_val = cur.fetchone()[0]
        cur.close()
        conn.close()
        return port_val
    except Exception as e:
        print(f"❌ 获取端口失败: {e}")
        return None

def update_config(pgdata, key, value):
    conf_path = os.path.join(pgdata, 'postgresql.conf')
    with open(conf_path, 'r') as f:
        lines = f.readlines()
    found = False
    for i, line in enumerate(lines):
        if line.strip().startswith(key + ' ='):
            lines[i] = f"{key} = {value}\n"
            found = True
            break
    if not found:
        lines.append(f"{key} = {value}\n")
    with open(conf_path, 'w') as f:
        f.writelines(lines)
    print(f"✅ 已更新配置: {key} = {value}")

def restart_postgres(pgdata):
    print("🔄 正在重启 PostgreSQL...")
    try:
        subprocess.run(
            ['pg_ctl', 'restart', '-D', pgdata, '-w', '-t', '30'],
            check=True,
            capture_output=True,
            text=True
        )
        print("✅ PostgreSQL 重启成功")
    except subprocess.CalledProcessError as e:
        print(f"❌ 重启失败: {e.stderr}")
        sys.exit(1)

def main():
    pgdata = get_pgdata()
    print("=== PostgreSQL 安装部署问题排查 Demo (Python) ===\n")

    # 步骤1
    print("【步骤 1】测试当前连接")
    if not test_connection(PORT):
        print("⚠️ 当前无法连接,请检查 PostgreSQL 是否正常运行")
        return

    # 步骤2
    print("\n【步骤 2】查看当前端口配置")
    cur_port = show_port(PORT)
    if cur_port is None:
        return
    print(f"当前端口: {cur_port}")

    # 步骤3
    print("\n【步骤 3】修改端口为 5433")
    update_config(pgdata, 'port', '5433')
    restart_postgres(pgdata)

    # 步骤4
    print("\n【步骤 4】使用新端口 5433 连接")
    if test_connection(5433):
        new_port = show_port(5433)
        if new_port:
            print(f"当前端口: {new_port}")

    # 步骤5
    print("\n【步骤 5】恢复端口为 5432")
    update_config(pgdata, 'port', '5432')
    restart_postgres(pgdata)

    print("\n✅ Demo 执行完成")

if __name__ == '__main__':
    main()

对应的 PostgreSQL 原生指令注释同 Go 版本,此处省略。

技术点总结
  • 使用 psycopg2 驱动连接 PostgreSQL
  • 通过游标执行 SHOW 查询
  • 文件读写修改配置文件
  • 使用 subprocess 调用 pg_ctl
  • 异常处理与超时控制

Java 版本

运行说明
  • 环境:JDK 11+,Maven 或 Gradle 管理依赖
  • 依赖:org.postgresql:postgresql:42.7.3
  • 编译运行:javac -cp "postgresql-42.7.3.jar" Demo.java && java -cp ".:postgresql-42.7.3.jar" Demo(Linux/Mac)或 ; 分隔(Windows)
代码
import java.sql.*;
import java.io.*;
import java.nio.file.*;
import java.util.*;
import java.util.concurrent.TimeUnit;

public class Demo {
    private static final String HOST = "localhost";
    private static final int PORT = 5432;
    private static final String USER = "postgres";
    private static final String PASSWORD = "postgres";
    private static final String DBNAME = "postgres";

    private static String getPgData() {
        String pgdata = System.getenv("PGDATA");
        if (pgdata == null || pgdata.isEmpty()) {
            pgdata = "/var/lib/pgsql/data";
        }
        return pgdata;
    }

    private static boolean testConnection(int port) {
        String url = String.format("jdbc:postgresql://%s:%d/%s", HOST, port, DBNAME);
        Properties props = new Properties();
        props.setProperty("user", USER);
        props.setProperty("password", PASSWORD);
        props.setProperty("connectTimeout", "5");
        try (Connection conn = DriverManager.getConnection(url, props)) {
            Statement stmt = conn.createStatement();
            ResultSet rs = stmt.executeQuery("SELECT version()");
            if (rs.next()) {
                System.out.println("✅ 连接成功: " + rs.getString(1));
            }
            rs.close();
            stmt.close();
            return true;
        } catch (SQLException e) {
            System.err.println("❌ 连接失败: " + e.getMessage());
            return false;
        }
    }

    private static String showPort(int port) {
        String url = String.format("jdbc:postgresql://%s:%d/%s", HOST, port, DBNAME);
        Properties props = new Properties();
        props.setProperty("user", USER);
        props.setProperty("password", PASSWORD);
        props.setProperty("connectTimeout", "5");
        try (Connection conn = DriverManager.getConnection(url, props);
             Statement stmt = conn.createStatement();
             ResultSet rs = stmt.executeQuery("SHOW port")) {
            if (rs.next()) {
                return rs.getString(1);
            }
        } catch (SQLException e) {
            System.err.println("❌ 获取端口失败: " + e.getMessage());
        }
        return null;
    }

    private static void updateConfig(String pgdata, String key, String value) throws IOException {
        Path confPath = Paths.get(pgdata, "postgresql.conf");
        List<String> lines = Files.readAllLines(confPath);
        boolean found = false;
        for (int i = 0; i < lines.size(); i++) {
            String line = lines.get(i).trim();
            if (line.startsWith(key + " =")) {
                lines.set(i, key + " = " + value);
                found = true;
                break;
            }
        }
        if (!found) {
            lines.add(key + " = " + value);
        }
        Files.write(confPath, lines, StandardOpenOption.TRUNCATE_EXISTING);
        System.out.println("✅ 已更新配置: " + key + " = " + value);
    }

    private static void restartPostgres(String pgdata) throws IOException, InterruptedException {
        System.out.println("🔄 正在重启 PostgreSQL...");
        ProcessBuilder pb = new ProcessBuilder("pg_ctl", "restart", "-D", pgdata, "-w", "-t", "30");
        pb.redirectErrorStream(true);
        Process p = pb.start();
        boolean finished = p.waitFor(30, TimeUnit.SECONDS);
        if (!finished) {
            p.destroyForcibly();
            throw new InterruptedException("重启超时");
        }
        int exitCode = p.exitValue();
        if (exitCode != 0) {
            try (BufferedReader reader = new BufferedReader(new InputStreamReader(p.getInputStream()))) {
                String line;
                while ((line = reader.readLine()) != null) {
                    System.err.println(line);
                }
            }
            throw new RuntimeException("pg_ctl 返回非零退出码: " + exitCode);
        }
        System.out.println("✅ PostgreSQL 重启成功");
    }

    public static void main(String[] args) {
        String pgdata = getPgData();
        System.out.println("=== PostgreSQL 安装部署问题排查 Demo (Java) ===\n");

        // 步骤1
        System.out.println("【步骤 1】测试当前连接");
        if (!testConnection(PORT)) {
            System.out.println("⚠️ 当前无法连接,请检查 PostgreSQL 是否正常运行");
            return;
        }

        // 步骤2
        System.out.println("\n【步骤 2】查看当前端口配置");
        String curPort = showPort(PORT);
        if (curPort == null) return;
        System.out.println("当前端口: " + curPort);

        // 步骤3
        System.out.println("\n【步骤 3】修改端口为 5433");
        try {
            updateConfig(pgdata, "port", "5433");
            restartPostgres(pgdata);
        } catch (Exception e) {
            System.err.println("❌ 操作失败: " + e.getMessage());
            return;
        }

        // 步骤4
        System.out.println("\n【步骤 4】使用新端口 5433 连接");
        if (testConnection(5433)) {
            String newPort = showPort(5433);
            if (newPort != null) {
                System.out.println("当前端口: " + newPort);
            }
        }

        // 步骤5
        System.out.println("\n【步骤 5】恢复端口为 5432");
        try {
            updateConfig(pgdata, "port", "5432");
            restartPostgres(pgdata);
        } catch (Exception e) {
            System.err.println("❌ 操作失败: " + e.getMessage());
            return;
        }

        System.out.println("\n✅ Demo 执行完成");
    }
}

对应的 PostgreSQL 原生指令注释同 Go 版本。

技术点总结
  • 使用 JDBC 驱动连接 PostgreSQL
  • DriverManager 获取连接,Statement 执行查询
  • 文件读写使用 Files 和 Paths API
  • 使用 ProcessBuilder 调用外部命令
  • 超时处理与异常捕获

所有示例均遵循相同的逻辑流程:连接测试 → 查询端口 → 修改配置 → 重启 → 验证新端口 → 恢复原端口。可根据实际环境调整 PGDATA 和数据库认证信息。

官方文档

参考链接

总结

本文系统梳理了 PostgreSQL 安装部署阶段最常遇到的五类问题:目录权限错误、端口冲突、监听配置不当、内存不足以及系统表索引损坏,并给出了每个问题的报错特征、排查步骤和解决方案。核心技术点包括 0700 权限要求、listen_addresses 与 port 配置、shared_buffers 与 max_connections 的内存调优,以及使用 ignore_system_indexes 紧急恢复损坏的系统表索引。

同时强调了日志(启动日志、CSV 日志、操作系统日志)是定位一切启动与连接问题的首要手段。文中提供的 Node.js 示例演示了如何编程化地修改配置并验证连接,可与原生 pg_ctl 和 psql 命令互为补充。掌握这些基础故障排查方法,能够显著提高数据库运维的效率和信心。

Pgsql常用函数及方法(持续更新) PostgreSQL是一个功能强大的开源对象关系型数据库系统,他使用和扩展了SQL语言,并结合了许多安全存储和扩展最复杂数据工作负载的功能,是目前功能最强大的开源数据库。 阅读详情

相关推荐

PostgreSQL 超详细安装与使用教程:从入门到实战

本文将详细介绍PostgreSQL数据库的安装配置与基础使用。首先从Windows系统安装入手,分步骤讲解17.5版本的安装流程、环境变量配置及服务启动验证。接着重点介绍了pgAdmin4图形化管理工具的安装与使用,包括界面语言设置、数据库连接、创建与管理数据库等操作,同时对比了可视化操作与SQL命令两种方式。最后梳理了PgSQL基础语法,涵盖表的创建、增删改查操作、约束管理等内容,为初学者提供了完整的PostgreSQL入门指南。文章兼顾理论知识与实际操作,既适合数据库新手学习,也可作为开发人员的快速参考

gtf212的博客 1万+

Windows 10 安装配置连接PostgreSQL教程

Windows 10 安装配置连接PostgreSQL教程

极客星云-优快云博客 2万+

PostgreSQL 安装指南:常见问题排查与实战解决方案

本文详细介绍了PostgreSQL安装过程中的常见问题排查与实战解决方案,包括环境准备、Windows和Linux/macOS系统下的典型问题处理、安全配置与性能调优,以及跨版本升级技巧。帮助用户快速解决安装难题,提升数据库部署效率。

weixin_42665725的博客 365

PostgreSQL安装详细步骤(linux)

官方安装文档:http://www.postgresql.org/download/linux/redhat/ 1. 检查PostgreSQL 是否已经安装 Linux-软件包管理-rpm命令管理-查询 rpm -qa | grep postgres 检查PostgreSQL 是否已经安装rpm -qal | grep postgres 检查PostgreSQL 安...

diaguo7961的博客 6566

Joplin Server避坑指南:Docker+PostgreSQL配置常见问题与解决方案

本文详细解析了Joplin Server在Docker和PostgreSQL环境下的常见配置问题与解决方案,涵盖数据库连接失败、同步错误等典型场景。针对NAS用户提供优化建议,包括内存调优、定期维护和多终端同步实践,帮助用户实现稳定高效的全终端适配笔记服务。

pytorchlight8的博客 824

PostgreSQL官方安装指南:Windows与macOS本地部署实操

PostgreSQL 是一款功能完备、高度可靠的关系型数据库,其本地安装是开发者接触数据库技术的第一步。理解安装本质即理解服务进程、数据目录与系统权限的协同机制;官方图形安装包通过固化路径、规范服务注册和明确版本二进制,保障了环境可控性与可复现性;相比包管理器(如 Homebrew)或容器方案,它更利于初学者建立对 PostgreSQL 启动流程、配置文件位置(postgresql.conf)、认证机制(pg_hba.conf)及用户权限模型的完整认知。本文聚焦 PostgreSQL 安装 与 Window

CURSED! 409

AI时代首先数据库-PostgreSQL实战笔记 | 11 PostgreSQL安装部署常见问题排查与解决

本文系统梳理了PostgreSQL安装部署中常见问题的排查路径,强调“日志先行”的核心原则。针对启动失败(如pid文件残留、权限错误、端口占用、配置语法错误、信号量不足)与连接失败(本地套接字问题、远程三重配置检查:listen_addresses、pg_hba.conf、防火墙/安全组)等典型场景,提供精准定位与解决方案。附带快速自检清单与命令示例,助力用户高效排除故障,提升PG运维效率。

源码获取 | 运行部署 | 定制二开修改,如果回复不及时请耐心等待,请见谅。 338

PostgreSQL生产环境安装部署:源码编译、配置与故障排查全指南

数据库的安装部署看似简单,实则隐藏着诸多生产环境陷阱。选择正确的安装方式,理解系统包、源码编译与容器化部署的差异,是构建稳定数据库服务的第一步。源码编译能提供完全可控的版本与目录布局,但需关注编译工具链、内核参数与磁盘规划。初始化数据目录时,合理的编码、认证方式与核心参数如shared_buffers、work_mem直接影响性能与安全。而pg_hba.conf配置错误、监听地址不当、socket权限问题,是远程连接失败的高频根因。掌握pg_ctl操作与日志排查技巧,结合pgbench压测与性能基线调整,能

weixin_31423955的博客 262

源码编译:在现代化环境中部署PostgreSQL 11的实战指南

本文详细介绍了在现代化环境中通过源码编译部署PostgreSQL 11的完整流程,包括环境准备、依赖安装、源码获取、编译配置、数据库初始化及安全加固等关键步骤。针对金融等需要特定版本数据库的场景,提供了实用的解决方案和常见问题排查技巧,帮助开发者高效完成PostgreSQL 11的安装与配置。

weixin_29214559的博客 349

保姆级教程:在Windows 10上为QT5.15.2配置Android开发环境(含SDK/NDK/JDK避坑指南)

本文提供了一份详细的Windows 10环境下为QT5.15.2配置Android开发环境的保姆级教程,涵盖SDK、NDK、JDK的安装与配置,以及常见问题的避坑指南。通过优化安装流程、解决Gradle下载慢等痛点,帮助开发者快速搭建稳定的编译环境,并提供了模拟器配置和调试技巧,确保开发效率。

weixin_30919571的博客 528

IPV6基本配置

IPV6配置,DHCPV6,华为模拟器,IPV6的M/O标志位

路漫漫其修远兮 4668

PostgreSQL 14.11中pgvector扩展启动失败深度排查与解决方案

你是否在PostgreSQL 14.11中遇到过pgvector扩展启动失败的问题?执行`CREATE EXTENSION vector;`时出现"无法打开扩展控制文件"或"版本不兼容"错误?本文将系统分析5种常见故障场景,提供经测试验证的解决方案,并附上官方工具与社区最佳实践,帮助你快速恢复向量搜索功能。 ## 故障场景与解决方案 ### 场景1:扩展文件缺失(ERROR: could no...

gitblog_00084的博客 685

反序列化漏洞详解

目录 一、什么是序列化和反序列化 二、什么是反序列化漏洞 三、序列化函数(serialize) 四、反序列化(unserialize) ​五、什么是PHP魔术方法 六、一些常见的魔术方法 七、魔术方法的利用 八、反序列化漏洞的利用 1.__destruct()函数 2.__wakeup() 3.toString() ​九、反序列化漏洞的防御 一、什么是序列化和反序列化 序列化是将对象转换为字符串以便存储传输的一种方式。而反序列化恰好就是序列化的逆过程,反序列化会将字符串.

LJH1999ZN的博客 3万+

Windows 11 实战:PostgreSQL 17 安装部署与 pgAdmin 4 疑难排解全指南

本文详细介绍了在Windows 11系统上安装和配置PostgreSQL 17的全过程,包括安装前的准备工作、pgAdmin 4的优化配置、常见问题排查以及高级功能扩展。特别针对Windows环境下的权限问题和性能调优提供了实用解决方案,帮助用户高效部署和管理PostgreSQL数据库。

weixin_30608503的博客 640

【实验】Linux下完全卸载oracle单实例(亲身体验完整版)

停止oracle数据库服务 停止监听 卸载数据库实例 因为自己懒得再弄dbca图形化界面啥的,直接采用dbca静默删除数据库实例,命令如下 dbca -silent -deleteDatabase -sourcedb orclhq -sid orcl -sysDBAUserName orcl -sysDBAPassword zte [oracle@slave ~]$ dbca -silent ...

萝卜吃鱼914的博客 1945

Android 白名单保活实战:主流厂商适配指南

本文详细解析了Android应用白名单保活的实战策略,重点针对华为、小米、OPPO、vivo等主流厂商的系统特性,提供了精准的后台设置页面跳转适配方案。文章从基础的前台服务实现讲起,深入讲解了白名单的判断、申请与厂商适配的核心代码与避坑指南,旨在帮助开发者合规、稳定地提升应用后台存活率。

motor的博客 1863

Kubernetes 部署 PostgreSQL 实战指南:stable/postgresql Helm Chart 配置与运维全解

本篇技术指南以 helm/charts 仓库中的 [stable/postgresql](https://link.gitcode.com/i/765117fdfc32c91a93a8bb4b0923a37f) 官方文档为核心,系统讲解如何在 Kubernetes 集群中使用 Helm 部署、配置与运维 PostgreSQL(对象关系型数据库 ORDBMS)。你将掌握从零开始安装、卸载、按参数表定

gitblog_01002的博客 635

人工智能大语言模型微调技术:SFT 监督微调、LoRA 微调方法、P-tuning v2 微调方法、Freeze 监督微调方法

人工智能大语言模型微调技术:SFT 监督微调、LoRA 微调方法、P-tuning v2 微调方法、Freeze 监督微调方法

丨汀、的博客 4万+

Windows 环境 PostgreSQL 18 安装与 pgvector 向量扩展部署文档

本文档详细介绍了在Windows环境下安装PostgreSQL 18并部署pgvector向量扩展的完整流程。主要内容包括:PostgreSQL 18.4的下载安装步骤、数据库初始化配置、pgvector扩展的两种部署方案(源码编译和手动部署预编译包)、扩展启用与功能验证方法,以及常见问题排查。文档提供了清晰的目录结构说明、SQL操作示例和可视化安装验证方法,特别针对Windows环境下的特殊配置要求(如Visual Studio依赖)给出了解决方案,帮助用户快速搭建支持向量搜索功能的PostgreSQL环

weixin_48053866的博客 795

黑猫带你学eMMC协议第17篇:超详细的eMMC HS200 & HS400讲解

1 前言 1.1 声明 本文依据eMMC JEDEC5.1及个人工作经验整理而成,如有错误请留言。 本文结合eMMC JEDEC5.1协议手册查看效果更佳。 1.2 内容提要 本文大约6000字,主要内容有: 1.什么是emmc hs200/hs400? 2.什么是tuning?tuning的过程又是什么? 3.如何设置才能让emmc进入hs200 mode? 4.如何设置才能让emmc进入hs400 mode? 5.emmc关于HS200/HS400内部结构框图对比。 6.部分个人相关经验总结。

黑猫奥利奥的博客 1万+

PDAF相位对焦原理

pdaf光路图

camerall 1万+

PostgreSQL 11.4 在 CentOS 7 上的完整安装与卸载指南(含常见问题解决)

本文提供了PostgreSQL 11.4在CentOS 7系统上的完整安装与卸载指南,包括环境准备、YUM/RPM两种安装方式、远程连接配置及常见问题解决方案。特别针对数据库初始化失败、远程连接被拒绝等典型问题提供了详细排查步骤,帮助技术人员高效部署这一开源关系型数据库。

weixin_29253711的博客 533

C# WinForm 基于DirectShow.dll编写的程序,可边预览边保存视频,音频和图片

基于微软的DirectShow.dll的二次开发1.自动识别连接的摄像头跟麦克风且可以对其进行选择(默认选中第一个)2.可录制wmv和avi两种格式的视频并且都带有音频,avi可以录制的分辨率和帧数进行选择,wmv默认进行了淸晰度优化如不喜欢可去除代码中有相关提示3.可在预览点开之后进行拍照,也可边录制视频边拍照4.添加了视频和音频的压缩功能(酌情使用)这次二次开发发现C#对DirectShow的相关信息太少,这次做完也不敢藏私共享出来,还望大家指正

BetterDB Monitor故障排查手册:常见问题诊断与解决方案指南

BetterDB Monitor是一款强大的Valkey和Redis实时监控工具,但在使用过程中可能会遇到各种连接、配置和部署问题。这份完整的故障排查手册将帮助你快速诊断并解决BetterDB Monitor的常见问题,确保你的数据库监控系统稳定运行。😊 ## 为什么需要BetterDB Monitor故障排查? BetterDB Monitor为Valkey和Redis数据库提供实时监控、

gitblog_00596的博客 686

jdk-8u144-linux-x64.tar.gz.

该资源为搭建Linux系统Java环境用,资源的后缀为tar.gz格式的压缩包

廖雪峰Python教程[完整版]

廖雪峰的python教程整理的,已经排好版了,而且还是完整的,适合小白

PostgreSQL 安装部署实战:版本选型、离线部署与排错指南

数据库作为应用系统的核心底座,其安装部署的规范程度直接影响后续的稳定性与运维效率。PostgreSQL 作为主流关系型数据库,在生产环境中常面临版本选型多样、离线环境依赖复杂、初始化和认证配置门槛高等挑战。理解 PostgreSQL 的发行策略与集群初始化原理,是正确部署的前提。在实际落地时,从包管理器、源码编译到 Docker 容器,不同方式各有适用场景,需结合内网环境、系统版本和安全要求综合规划。同时,pg_hba.conf 的认证配置、监听地址调整、基础参数调优以及数据目录规划,都是保障服务平稳运行的

weixin_30512965的博客 337

NTscan扫描工具

ntscan是一个扫描器,可以扫描没有密码和弱密码的共享,先到配置文件中填写猜测的用户名和密码,扫描过程中右侧出现的是扫描日志。

上一篇: PostgreSQL笔记10:pgAdmin与DBeaver图形化管理工具详解
下一篇: PostgreSQL笔记12:PGDATA 数据目录结构与核心文件深度解析
Wang's Blog
博客等级 码龄12年 7440粉丝 2427原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

Wang's Blog

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值