讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

Seko
Seko

AI短剧一键生成成片

PostgreSQL默认端口被占用如何连接_修改端口号操作教程

陌伟姑娘_8451

陌伟姑娘_8451

发布时间:2026-03-11 11:12:04

|

352人浏览过

|

来源于php中文网

原创

PostgreSQL 默认端口5432被占用时,需先查冲突进程(如lsof或Get-NetTCPConnection),再决定杀进程或改配置;修改postgresql.conf的port后必须reload服务,并同步更新所有客户端连接配置。

postgresql 默认端口(5432)被占用时,不能靠“重启服务”硬扛,必须先确认冲突进程、再决定是杀掉它还是改 postgresql 的监听端口。

怎么查哪个进程占了 5432 端口

Linux/macOS 直接跑命令,Windows 用 netstat 或 Get-NetTCPConnection:

  • Linux/macOS:lsof -i :5432 或 sudo ss -tulpn | grep ':5432'
  • Windows PowerShell:Get-NetTCPConnection -LocalPort 5432 | Get-Process
  • 看到 PID 后,用 ps -p PID -o comm=(Linux/macOS)或 tasklist /FI "PID eq PID"(Windows)确认是不是另一个 postgres 实例、Docker 容器,或者开发工具(如 TablePlus、DBeaver 自带的嵌入式服务)

改 postgresql.conf 的 port 参数前必看

别急着改配置——改完不 reload 或不重启,port 设置不会生效;而且客户端连接字符串也得同步更新,否则连不上。

  • 配置文件路径通常在:/etc/postgresql/*/main/postgresql.conf(Debian/Ubuntu)、/var/lib/pgsql/data/postgresql.conf(RHEL/CentOS)、~/Library/Application Support/Postgres/var-*/postgresql.conf(macOS Homebrew)
  • 找到并修改这一行:port = 5432 → 改成比如 port = 5433
  • 改完必须执行:pg_ctl reload(如果用 pg_ctl 启动),或 sudo systemctl reload postgresql(systemd 管理),不能只改文件就以为完事
  • 注意:如果启用了 ssl = on,换端口后证书绑定不受影响;但反向代理(如 nginx)或云服务商安全组规则要手动同步放行新端口

客户端连接时端口写错的典型表现

不是报“密码错误”,而是更底层的连接失败,容易误判:

  • psql: error: connection to server at "localhost" (127.0.0.1), port 5432 failed: Connection refused —— 即使你改了服务端口,但 psql 还默认连 5432
  • 连接字符串里漏写 port 参数,例如 postgresql://user@localhost/db 默认走 5432,必须显式写成 postgresql://user@localhost:5433/db
  • ORM(如 Django、SQLAlchemy)配置里 PORT 或 port 键值没更新,日志里看不到 SQL 错误,只卡在初始化连接池阶段

端口冲突本身不难解,难的是改完服务端忘了同步改所有调用方的连接配置,尤其是测试脚本、CI 配置、Docker Compose 的 ports 映射、还有那些藏在 .env 里没被 git 跟踪的本地调试配置。

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
postgresql常用命令
postgresql常用命令

postgresql常用命令psql、createdb、dropdb、createuser、dropuser、l、c、dt、d table_name、du、i file_name、e和q等。本专题为大家提供postgresql相关的文章、下载、课程内容,供大家免费下载体验。

233

2023.10.10

常用的数据库软件
常用的数据库软件

常用的数据库软件有MySQL、Oracle、SQL Server、PostgreSQL、MongoDB、Redis、Cassandra、Hadoop、Spark和Amazon DynamoDB。更多关于数据库软件的内容详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5029

2023.11.02

postgresql常用命令有哪些
postgresql常用命令有哪些

postgresql常用命令psql、createdb、dropdb、createuser、dropuser、l、c、dt、d table_name、du、i file_name、e和q等。更详细的postgresql常用命令,大家可以访问下面的文章。

647

2023.11.16

postgresql常用命令介绍
postgresql常用命令介绍

postgresql常用命令有l、d、d5、di、ds、dv、df、dn、db、dg、dp、c、pset、show search_path、ALTER TABLE、INSERT INTO、UPDATE、DELETE FROM、SELECT等。想了解更多postgresql的相关内容,可以阅读本专题下面的文章。

1396

2023.11.20

PostgreSQL性能优化与索引调优实战
PostgreSQL性能优化与索引调优实战

本专题面向后端开发与数据库工程师,深入讲解 PostgreSQL 查询优化原理与索引机制。内容包括执行计划分析、常见索引类型对比、慢查询优化策略、事务隔离级别以及高并发场景下的性能调优技巧。通过实战案例解析,帮助开发者提升数据库响应速度与系统稳定性。

500

2026.02.12

PostgreSQL 性能优化与查询执行计划实战
PostgreSQL 性能优化与查询执行计划实战

本专题深入解析PostgreSQL性能优化核心,聚焦查询执行计划的实战应用。通过EXPLAIN命令精准定位瓶颈,结合索引策略、SQL改写与参数调优,系统提升查询效率。从执行计划解读到性能调优全流程,助你掌握数据库性能诊断与优化实战能力。

170

2026.05.08

PostgreSQL 在 Next.js / Go 全栈架构中的工程化实践
PostgreSQL 在 Next.js / Go 全栈架构中的工程化实践

本文详解如何利用Next.js(搭配Drizzle ORM)与Go后端构建高性能应用,充分发挥PG在JSONB非结构化存储与pgvector向量检索上的优势。从数据建模到Docker容器化部署,打造支持AI时代的“One Database”工程化解决方案。

921

2026.05.08

PostgreSQL高级特性、内核机制与现代数据架构
PostgreSQL高级特性、内核机制与现代数据架构

本专题从MVCC并发控制与WAL日志等内核机制出发,详解JSONB、PostGIS及pgvector等高级特性。探讨如何利用单一引擎支撑关系型、向量及图数据等现代数据架构需求,助您掌握构建高并发、智能化应用的核心技术。

264

2026.05.08

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn