ARTICLE DETAIL

建站实战干货

来自一线的建站与推广经验沉淀，每一条都经过真实交付验证。

首页 / 资讯中心 / 正文

PostgreSQL源码编译安装：从环境准备到生产部署的完整指南

2026/8/6 9:01:09 拓冰建站 浏览量
PostgreSQL源码编译安装：从环境准备到生产部署的完整指南 1. 为什么选择源码编译安装PostgreSQL在Linux上部署PostgreSQL你可能会发现至少有三种主流方式直接用发行版的包管理器比如apt install postgresql或yum install postgresql-server、使用官方或第三方提供的二进制包、以及我们今天要聊的源码编译安装。很多人一听到“源码编译”就觉得头大觉得那是大神或者闲得慌的人才干的事。但说实话对于想在Linux服务器上长期、稳定、深度使用PostgreSQL的开发者或运维来说源码编译安装这条路走通了之后你会发现它带来的掌控感和灵活性是其他安装方式很难比拟的。包管理器安装确实方便一条命令完事。但它有个致命问题版本往往滞后。主流Linux发行版的稳定版仓库为了求稳里面的PostgreSQL版本可能比最新稳定版落后好几个小版本甚至一个大版本。当你需要用到某个新版本才有的特性或者遇到了一个只在旧版本存在的Bug时就会非常被动。二进制包通常版本会新一些但它的编译参数是固定的你可能无法启用某些针对你硬件优化的特性比如特定的CPU指令集优化也无法精细地控制安装路径和组件。而源码编译安装就是把主动权完全拿回自己手里。你可以指定最新的稳定版本可以为了极致性能启用针对你CPU架构的编译优化可以把数据目录、日志目录、二进制文件安装到任何你想要的、符合你运维规范的位置。整个过程就像自己从零开始组装一台机器每个螺丝拧多紧用什么型号的零件你心里都有数。这对于生产环境的标准化部署、性能调优的前置准备以及深入理解PostgreSQL的组成结构都有着不可替代的价值。当然这条路也不是一片坦途。你需要自己解决依赖库漫长的编译过程对机器资源是个考验出错了排查起来也需要一些Linux基础。但别担心这正是这篇超详细指南存在的意义。我会把我自己多次在CentOS、Ubuntu等不同发行版上编译安装PostgreSQL的经验包括那些容易踩坑的细节和“原来如此”的瞬间都毫无保留地分享出来。我们不止要“跑通”更要明白每一步在做什么以及为什么这么做。2. 编译前的战场准备环境与依赖兵马未动粮草先行。编译一个像PostgreSQL这样的大型C项目一个干净、完备的构建环境是成功的一半。这一步没做好后面可能会遇到各种光怪陆离的错误。2.1 系统与用户准备首先确保你有一个干净的Linux环境。我个人的经验是尽量避免在个人桌面环境或者已经有其他数据库服务的机器上直接操作最好是一台新装的虚拟机或云服务器。这里我以CentOS 7/Rocky Linux 8和Ubuntu 20.04/22.04这两个最主流的服务器发行版为例进行说明其他发行版可以举一反三。编译和安装软件需要超级用户权限但我们不应该全程使用root用户。最佳实践是用root或sudo安装系统依赖包然后创建一个专门的普通用户例如postgres来执行编译、安装以及后续的数据库运行管理。这符合最小权限原则更安全。# 在CentOS/Rocky Linux上创建用户和组 sudo groupadd postgres sudo useradd -g postgres postgres # 设置一个强密码或者后续配置无密码sudo仅限受控环境 sudo passwd postgres # 在Ubuntu/Debian上adduser命令交互性更好 sudo adduser --system --group --shell /bin/bash postgres接下来我们选择一个合适的目录来存放源码和进行编译。通常我会在/usr/local/src下操作因为这是存放本地安装软件源码的惯例位置。sudo mkdir -p /usr/local/src sudo chown -R postgres:postgres /usr/local/src cd /usr/local/src现在切换到我们刚创建的postgres用户来执行后续的下载和编译操作安装到系统目录时仍需sudo。sudo su - postgres cd /usr/local/src2.2 攻克依赖关那些必须安装的“零件”PostgreSQL的编译依赖一系列开发库和工具。缺少它们configure脚本会报错或者即使编译通过运行时也会缺少关键功能。不同发行版的包管理器不同安装命令也不同。对于基于RPM的发行版CentOS 7, Rocky Linux 8, AlmaLinux等# 首先确保系统已更新 sudo yum update -y # 安装编译工具链和基础库 sudo yum groupinstall -y Development Tools # 安装PostgreSQL编译所需的特定依赖 sudo yum install -y readline-devel zlib-devel openssl-devel libxml2-devel libxslt-devel systemd-devel注意readline-devel提供了命令行历史编辑功能没有它psql客户端会很难用。zlib-devel用于压缩支持。openssl-devel如果你想启用SSL连接加密就必须装。libxml2-devel和libxslt-devel是用于XML相关功能的。systemd-devel则是在使用systemd管理的系统上集成服务所必需的。对于基于Debian的发行版Ubuntu, Debian等# 更新软件包列表 sudo apt update # 安装编译工具链 sudo apt install -y build-essential # 安装PostgreSQL编译所需的特定依赖 sudo apt install -y libreadline-dev zlib1g-dev libssl-dev libxml2-dev libxslt-dev libsystemd-dev有时候你可能还需要一些可选依赖来支持额外功能比如用于地理空间数据的PostGIS需要gdal、proj等但对于PostgreSQL核心安装上面这些已经足够。验证一下关键工具是否就位# 检查gcc编译器 gcc --version # 检查make工具 make --version如果这些命令都能输出版本信息那么基础工具链就准备好了。3. 获取源码与配置选择与定制环境准备好了现在让我们把PostgreSQL的“蓝图”——源代码拿到手并进行个性化定制。3.1 下载与解压获取正确的版本永远建议从PostgreSQL官方站点https://www.postgresql.org/ftp/source/下载源码。这样能确保代码的完整性和安全性。不要从第三方不明镜像站下载。打开官网找到最新稳定版Stable的目录。比如目前是PostgreSQL 16.x系列。我们选择.tar.bz2或.tar.gz格式的压缩包两者区别不大.tar.bz2通常压缩率更高文件更小。# 以PostgreSQL 16.3为例使用wget下载 wget https://ftp.postgresql.org/pub/source/v16.3/postgresql-16.3.tar.bz2 # 如果网络较慢可以尝试国内的镜像源如华为云镜像 # wget https://mirrors.huaweicloud.com/postgresql/source/v16.3/postgresql-16.3.tar.bz2 # 下载完成后解压源码包 tar -xvf postgresql-16.3.tar.bz2 # 进入解压后的目录 cd postgresql-16.3解压后你会看到一个结构清晰的源码目录其中configure、Makefile、src等是核心。3.2 运行configure定义你的PostgreSQLconfigure脚本是自动化编译的“大脑”。它会检查你的系统环境检测所有必需的依赖是否满足并根据你提供的参数生成量身定制的Makefile。这一步的选项选择直接决定了最终编译出的PostgreSQL具备哪些功能、安装在哪里。让我们来看一个我常用于生产环境的配置命令示例并逐行解释./configure \ --prefix/usr/local/pgsql/16.3 \ --with-openssl \ --with-libxml \ --with-libxslt \ --with-systemd \ --with-uuidossp \ --with-pgport5432 \ --with-perl \ --with-python \ --with-tcl \ --with-icu \ --enable-debug \ --enable-dtrace \ --enable-nls \ CFLAGS-O2 -marchnative \ LDFLAGS-Wl,-rpath,/usr/local/pgsql/16.3/lib现在我们来拆解这些参数理解它们背后的“为什么”--prefix/usr/local/pgsql/16.3这是最重要的参数指定了软件的安装根目录。我强烈建议将版本号包含在路径中例如/usr/local/pgsql/16.3。这样做的好处是你可以在同一台机器上并行安装多个版本的PostgreSQL比如15.5和16.3它们互不干扰。未来升级时只需安装到新目录如/usr/local/pgsql/17.0然后切换软链接或服务指向即可回滚也极其方便。--with-openssl、--with-libxml、--with-libxslt启用这些功能需要我们在上一步安装了对应的-devel开发包。它们分别提供SSL加密连接、XML数据类型和支持、以及XSLT转换支持。对于需要安全连接或处理XML数据的应用这些是必选项。--with-systemd如果你的Linux发行版使用systemd作为初始化系统CentOS 7, Ubuntu 16.04 基本都是启用这个选项可以让后续生成的服务单元文件.service更规范便于用systemctl管理数据库服务。--with-uuidossp启用UUID数据类型生成支持。ossp是一种实现库你需要额外安装ossp-uuid或uuid的开发包如libossp-uuid-devon Ubuntu。如果系统没有可以去掉此参数或尝试--with-uuide2fs使用e2fsprogs的UUID库。--with-pgport5432设置默认的监听端口。5432是PostgreSQL的惯例端口除非有冲突否则不建议修改。--with-perl、--with-python、--with-tcl启用对相应脚本语言的过程语言支持PL/Perl, PL/Python, PL/Tcl。这允许你在数据库函数中直接写Perl、Python或Tcl代码。如果你确定不需要可以去掉以简化编译。注意启用--with-python可能需要你系统安装对应版本的Python开发包如python3-dev。--with-icu启用ICUInternational Components for Unicode库支持提供更强大的国际化排序和字符处理能力。需要安装libicu-dev或icu-devel。--enable-debug在二进制文件中包含调试符号。这对于后期排查核心转储core dump问题非常有用但会略微增大二进制文件体积。生产环境可以不启用。--enable-dtrace启用DTrace探测点支持。DTrace是一个强大的动态跟踪框架用于性能分析和故障诊断。只有少数系统如Solaris, FreeBSD, macOS原生支持Linux上需要额外的适配。通常可以不加。--enable-nls启用本地化语言支持Native Language Support。如果你需要非英语的错误消息可以启用并配合LANG环境变量使用。CFLAGS-O2 -marchnative这是传递给C编译器的优化标志。-O2是标准的优化级别在编译速度和代码性能间取得平衡。-marchnative是一个“神技”它告诉编译器“请针对我当前正在运行的这台CPU的精确型号生成最优化的指令集代码”。这能最大程度榨取你硬件的性能特别是对于有AVX2、AVX-512等高级指令集的现代CPU。注意如果你编译的环境如容器和最终运行的环境如另一台物理机CPU架构不同绝对不能使用-marchnative否则编译出的二进制文件在新机器上可能无法运行。这种情况下应省略此标志或使用更通用的-marchx86-64。LDFLAGS-Wl,-rpath,/usr/local/pgsql/16.3/lib这个参数解决了运行时库查找路径问题。它告诉链接器在生成的可执行文件中硬编码一个运行时库搜索路径rpath。这样当你运行/usr/local/pgsql/16.3/bin/psql时它会自动去/usr/local/pgsql/16.3/lib下找对应的libpq.so等库文件而不需要你再去设置LD_LIBRARY_PATH环境变量使得部署更简洁。执行configure脚本后它会输出一个长长的检查报告。请务必仔细阅读最后几行确保所有你需要的特性都显示为“yes”而不是“no”或“找不到库”。如果出现“no”通常意味着对应的开发包没装你需要根据错误提示安装相应的-devel或-dev包然后重新运行./configure。4. 编译、测试与安装从源码到可执行文件配置成功后目录下会生成适配你系统的Makefile。接下来就是经典的make三部曲。4.1 编译让机器开始工作使用make命令开始编译。这个过程会消耗大量CPU和内存时间长短取决于你的机器性能从十几分钟到一小时不等。make -j$(nproc)这里用到了-j$(nproc)参数。nproc命令会返回你CPU的核心数-j选项告诉make工具进行并行编译充分利用多核CPU这能显著缩短编译时间。你可以观察CPU使用率瞬间飙到接近100%风扇开始呼啸这是正常的。实操心得编译过程中如果遇到错误最常见的原因仍然是依赖缺失但此时报错信息可能更具体。仔细阅读错误输出它通常会告诉你哪个.c文件、哪一行、调用了哪个函数失败了。根据这个线索去搜索往往能很快定位到缺失的库。另一个常见问题是内存不足特别是在小内存的虚拟机上。如果编译进程被杀死Killed可以尝试不使用-j参数或者使用-j2限制并行任务数以减少内存峰值使用量。4.2 可选步骤运行回归测试编译完成后强烈建议运行PostgreSQL自带的回归测试套件。这是一个验证你的编译产物在当前系统环境下是否基本正常的有效手段。make check # 或者如果你想看到更详细的输出可以指定并行测试 make check-world PG_TEST_EXTRA--verbose测试会运行大量案例需要一些时间。最终如果所有测试通过你会看到类似All 187 tests passed.的总结信息。如果有测试失败不要慌张。首先看失败的具体是什么测试有时一些与环境相关的测试如时区、权限可能会失败这不一定代表你的编译有问题。但如果核心的功能测试大量失败就需要回头检查你的编译环境和配置了。注意事项运行测试可能需要一个可用的普通用户非root并且可能需要系统支持共享内存。如果测试失败提示与权限或内存有关可以查阅源码目录下的src/test/regress/README文件。4.3 安装将成果部署到系统测试通过后就可以安装了。安装需要向--prefix指定的系统目录如/usr/local/pgsql/16.3写入文件因此需要root权限。# 退出postgres用户回到有sudo权限的用户 exit # 使用sudo进行安装 sudo make install这个命令会将编译好的二进制文件如postgres,psql,pg_ctl、库文件、头文件、文档等按照configure阶段设定的布局复制到/usr/local/pgsql/16.3目录下。为了后续使用方便我们通常会把主要二进制文件所在的目录/usr/local/pgsql/16.3/bin添加到系统的PATH环境变量中这样在任何位置都可以直接输入psql等命令。# 对于当前会话临时生效 export PATH/usr/local/pgsql/16.3/bin:$PATH # 为了永久生效可以将其添加到对应用户的shell配置文件中如 ~/.bashrc 或 /etc/profile.d/ 下新建一个脚本 echo export PATH/usr/local/pgsql/16.3/bin:$PATH | sudo tee /etc/profile.d/pgsql.sh source /etc/profile.d/pgsql.sh现在你可以验证一下安装是否成功which psql # 应该输出 /usr/local/pgsql/16.3/bin/psql psql --version # 应该输出 PostgreSQL 16.3 的版本信息5. 初始化数据库集群与基础配置安装好软件相当于只准备好了“数据库管理系统”这个工具。要真正存储数据我们还需要创建一个“数据库集群”。在PostgreSQL术语中一个数据库集群是指由一个PostgreSQL服务器实例管理的单个数据目录里面可以包含多个数据库。5.1 创建数据目录并初始化首先选择一个地方存放你的数据。生产环境通常会放在一个独立的、空间充足的分区比如/data/pgsql或/var/lib/pgsql。这里我们以/data/pgsql/16.3/data为例。# 创建数据目录并赋予postgres用户所有权 sudo mkdir -p /data/pgsql/16.3/data sudo chown -R postgres:postgres /data/pgsql sudo chmod 700 /data/pgsql/16.3/data # 确保只有所有者有读写执行权限现在切换到postgres用户使用initdb命令初始化数据库集群。sudo su - postgres # 确保PATH包含了我们的pgsql bin目录 export PATH/usr/local/pgsql/16.3/bin:$PATH # 初始化数据库集群 initdb -D /data/pgsql/16.3/data -E UTF8 --localeen_US.UTF-8参数解释-D /data/pgsql/16.3/data指定数据目录位置。-E UTF8设置默认的数据库编码为UTF-8这是目前最通用、支持最好的编码强烈建议使用。--localeen_US.UTF-8设置集群的默认区域locale影响排序规则、日期格式等。请根据你的系统locale设置使用locale -a查看可用的选项。初始化成功后你会在数据目录下看到PG_VERSION,postgresql.conf,pg_hba.conf等核心文件。5.2 核心配置文件调优初次启动必改在启动数据库之前有两个配置文件必须根据你的环境进行调整postgresql.conf主配置和pg_hba.conf客户端认证配置。1. 调整postgresql.conf用编辑器打开数据目录下的postgresql.conf。对于初次启动我们至少需要修改监听地址否则只能本机连接。cd /data/pgsql/16.3/data vim postgresql.conf找到并修改以下行如果被注释则取消注释并修改值# 监听所有IP地址这样其他机器才能连接。生产环境请根据安全需求缩小范围如特定IP。 listen_addresses * # 默认端口如果没改configure的--with-pgport这里就是5432 port 5432 # 共享内存大小用于缓存等。初始可以设为系统内存的25%。例如8G内存的机器可设为2GB (2048MB) shared_buffers 2GB # 最大连接数根据应用需求调整。默认100通常不够。 max_connections 2002. 调整pg_hba.conf这个文件控制谁能以什么方式连接到数据库。初始配置非常严格。为了能从本地网络的其他机器连接我们需要添加规则。vim pg_hba.conf在文件末尾添加类似下面的行请根据你的网络环境调整# 允许本地所有用户通过Unix域套接字以trust方式连接默认已有用于本地管理 local all all trust # 允许本地所有用户通过TCP/IP以md5密码方式连接 host all all 127.0.0.1/32 md5 # 允许来自内网网段例如192.168.1.0/24的所有机器以md5密码方式连接所有数据库 host all all 192.168.1.0/24 md5 # 允许来自任意IP的特定用户如myuser连接特定数据库如mydb使用scram-sha-256强密码认证推荐 host mydb myuser 0.0.0.0/0 scram-sha-256安全警告trust认证方式意味着无需密码非常危险仅限用于本机socket连接的管理。md5是传统的密码认证尚可接受。scram-sha-256是PostgreSQL 10引入的更安全的认证方式推荐使用。规则顺序很重要第一条匹配的规则生效。生产环境务必根据最小权限原则配置精确的IP、数据库和用户。5.3 启动数据库服务配置完成后就可以启动数据库了。有多种启动方式方式一使用pg_ctl手动启动适合测试和临时启动# 在postgres用户下执行 pg_ctl -D /data/pgsql/16.3/data -l /data/pgsql/16.3/logfile start-l参数指定了日志输出文件。方式二配置为systemd服务推荐用于生产环境退出postgres用户回到有sudo权限的用户。exitPostgreSQL源码在contrib/systemd/目录下提供了服务单元文件模板。我们可以复制并修改它。sudo cp /usr/local/src/postgresql-16.3/contrib/systemd/postgresql.service /etc/systemd/system/postgresql-16.3.service sudo vim /etc/systemd/system/postgresql-16.3.service关键修改项根据你的实际路径调整[Unit] DescriptionPostgreSQL 16.3 Database Server Aftersyslog.target Afternetwork.target [Service] Typenotify Userpostgres Grouppostgres # 注意这里Environment后面可以设置变量但更关键的是下面两行 # 设置环境变量特别是PATH和PGDATA EnvironmentPGDATA/data/pgsql/16.3/data # 设置启动命令指定数据目录 ExecStart/usr/local/pgsql/16.3/bin/postgres -D ${PGDATA} ExecReload/bin/kill -HUP $MAINPID KillModemixed KillSignalSIGINT TimeoutSec0 [Install] WantedBymulti-user.target然后重新加载systemd配置启用并启动服务sudo systemctl daemon-reload sudo systemctl enable postgresql-16.3.service # 设置开机自启 sudo systemctl start postgresql-16.3.service # 立即启动 sudo systemctl status postgresql-16.3.service # 查看状态如果状态显示active (running)并且用psql可以连接那么恭喜你一个由源码编译安装的PostgreSQL数据库服务已经成功运行起来了# 切换到postgres用户连接默认的postgres数据库 sudo su - postgres psql -d postgres # 如果成功会进入 psql 命令行界面显示 postgres#6. 编译安装后的关键操作与深度优化数据库跑起来只是第一步要让其稳定、高效地服务于生产还需要进行一系列“售后”工作。6.1 设置开机自启与日志管理如果你使用systemd服务前面systemctl enable已经设置了开机自启。确保服务配置正确并且WantedBymulti-user.target这样系统进入多用户模式时就会自动启动PostgreSQL。日志管理至关重要。在postgresql.conf中你可以配置日志的输出方式# 将日志输出到单独的文件并按天或按大小切割 logging_collector on log_directory log log_filename postgresql-%Y-%m-%d_%H%M%S.log log_rotation_age 1d log_rotation_size 100MB log_min_duration_statement 1000 # 记录执行时间超过1秒的语句用于性能分析配置后重启服务生效。日志文件将位于数据目录下的log子目录中例如/data/pgsql/16.3/data/log。建议配合logrotate工具进行日志的压缩、归档和定期删除防止日志撑满磁盘。6.2 性能参数初步调优postgresql.conf里有上百个参数初次部署可以重点关注以下几个对性能影响显著的# 根据你的内存大小调整。专用数据库服务器可设为系统内存的 1/4。 shared_buffers 4GB # 工作内存用于排序、哈希等操作。通常设为 32MB - 128MB。 work_mem 64MB # 维护操作如VACUUM, CREATE INDEX可用的内存。可设大一些如256MB。 maintenance_work_mem 256MB # 预写式日志缓冲区大小。默认即可如果写负载极高可适当增加如16MB。 wal_buffers -1 # -1表示根据shared_buffers自动设置通常为shared_buffers的1/32 # 提交延迟为了性能可以设为on但牺牲一点持久性在崩溃时可能丢失最近几毫秒的数据。生产环境需权衡。 synchronous_commit on # 检查点相关影响恢复时间和性能波动。根据磁盘IOPS调整。 max_wal_size 2GB min_wal_size 1GB checkpoint_completion_target 0.9调整原则没有一个配置适合所有场景。这些初始值需要你在数据库运行一段时间后结合监控数据如检查点频率、缓存命中率、锁等待进行持续调整。使用pg_stat_statements扩展来追踪慢SQL是调优的起点。6.3 安装常用扩展PostgreSQL的强大功能之一是其可扩展性。许多有用的功能以“扩展Extension”的形式提供。编译安装后一些扩展的二进制文件已经安装在lib目录下但需要在数据库中执行CREATE EXTENSION来启用。首先以超级用户身份连接数据库安装pg_stat_statements用于统计SQL执行情况和uuid-ossp如果编译时启用了uuid支持-- 在psql命令行中执行 CREATE EXTENSION IF NOT EXISTS pg_stat_statements; CREATE EXTENSION IF NOT EXISTS uuid-ossp;要查看所有可用扩展可以查询pg_available_extensions视图。6.4 日常维护与备份策略源码安装的PostgreSQL其维护工具如pg_dump,pg_basebackup,vacuumdb都在bin目录下。你需要熟悉它们逻辑备份pg_dump和pg_dumpall。用于备份单个数据库或整个集群生成SQL脚本。pg_dump -h localhost -U postgres mydb mydb_backup.sql物理备份pg_basebackup。用于做基础备份是建立PITR时间点恢复和流复制的基础。pg_basebackup -D /backup/pgsql_basebackup -Ft -z -P -U replicauser定期清理VACUUMPostgreSQL的MVCC机制需要定期清理旧版本数据。虽然 autovacuum 通常会自动处理但对于特别繁忙的表可能需要在业务低峰期手动执行。vacuumdb --analyze --verbose mydb制定备份策略至少应包括每日全量逻辑备份并保留最近7-30天。对于重要数据应结合WAL归档实现PITR。将备份脚本加入cron定时任务。7. 故障排查与常见问题锦囊即使按照指南操作你也可能会遇到一些问题。这里汇总一些编译安装后常见的“坑”及其解决方案。7.1 服务启动失败问题执行systemctl start或pg_ctl start后服务立即停止或无法连接。排查步骤查日志这是第一要务查看数据目录下的log文件或者systemd的日志sudo journalctl -u postgresql-16.3.service -f。错误信息通常会明确指出问题如“无法绑定端口”、“权限被拒绝”、“配置文件语法错误”。检查端口占用netstat -tlnp | grep 5432。如果端口被其他进程占用要么停止那个进程要么修改postgresql.conf中的port。检查数据目录权限确保/data/pgsql/16.3/data及其所有子目录的所有者和组都是postgres且权限是700或750。检查配置文件语法postgresql.conf或pg_hba.conf中如果有拼写错误或无效值会导致启动失败。可以用postgres --check-config检查或者用pg_ctl start -D /your/data/dir -l logfile启动然后立刻查看logfile。7.2 客户端连接被拒绝问题psql -h 服务器IP -U 用户名 数据库名提示连接被拒绝。排查步骤确认服务在运行且监听正确在服务器上执行ss -tlnp | grep 5432确认PostgreSQL进程正在监听0.0.0.0:5432或具体的IP。检查pg_hba.conf这是最常见的原因。确认你客户端的IP地址匹配pg_hba.conf中某条host规则的地址范围并且认证方法md5,scram-sha-256等正确。修改pg_hba.conf后必须重载配置sudo systemctl reload postgresql-16.3.service或 在psql中执行SELECT pg_reload_conf();。检查防火墙CentOS的firewalld或Ubuntu的ufw可能屏蔽了5432端口。需要添加规则放行# CentOS/Rocky Linux sudo firewall-cmd --permanent --add-port5432/tcp sudo firewall-cmd --reload # Ubuntu sudo ufw allow 5432/tcp检查用户和数据库是否存在确保你连接的用户名和数据库名在PostgreSQL中已经创建。7.3 性能问题编译参数的影响问题感觉数据库性能没有达到预期特别是计算密集型操作。回顾这很可能与编译时的CFLAGS有关。如果你使用了-marchnative在A机器编译然后将二进制文件拷贝到B机器运行而B机器的CPU不支持某些指令集比如AVX2程序可能会崩溃或运行缓慢。解决方案在目标运行环境上重新编译或者使用更通用的编译标志如-marchx86-64 -mtunegeneric。7.4 升级与迁移源码编译安装的升级本质上是“侧载”Side-by-Side安装。假设你要从16.3升级到16.4按照上述流程将PostgreSQL 16.4编译安装到新目录如/usr/local/pgsql/16.4。停止旧版本服务sudo systemctl stop postgresql-16.3。使用pg_upgrade工具进行原地数据升级最快但需版本相邻且兼容或者使用pg_dumpall逻辑导出再导入到新版本最安全兼容性好但耗时。更新systemd服务文件指向新的二进制路径和数据目录。启动新版本服务并彻底测试。整个过程需要在业务低峰期进行并做好完整的备份。