PostgreSQL之连接失败的问题及解决

PostgreSQL是一个开源的、高度可扩展的关系型数据库管理系统，在使用过程中可能会遇到连接失败的问题，本文将介绍如何解决这个问题。

问题分析

当连接PostgreSQL时，可能会出现以下错误提示：

FATAL:  could not connect to server: Operation timed out (0x0000274C/10060)
Is the server running on host "127.0.0.1" and accepting
TCP/IP connections on port 5432?

这个错误提示表示连接超时，即连接PostgreSQL服务器的时间过长。错误的原因可能是以下几点：

• 服务器未开启或正在运行的服务器端口不是默认的5432
• PostgreSQL配置文件中没有允许访问该服务器的IP地址
• 防火墙阻止了对该端口的访问

接下来，我们将针对上述原因提供相应的解决方案。

解决方案

服务器未开启或正在运行的服务器端口不是默认的5432

如果服务器未开启，则需要手动开启服务器。如果正在运行的服务器端口不是默认的5432，则需要检查配置文件中的端口号，并使用正确的端口访问服务器。

在Windows操作系统中，可以通过以下步骤开启服务器：

1. 启动pgAdmin，找到PostgreSQL服务，并将其启动。

2. 运行命令提示符，输入以下命令来检查是否开启数据库服务器：

netstat -an | grep 5432

如果端口是开放的，则会看到以下输出：

TCP 127.0.0.1:5432 0.0.0.0:0 LISTENING
TCP <计算机本地IP>:5432 <计算机本地IP>:53120 ESTABLISHED
TCP <计算机本地IP>:53120 <计算机本地IP>:5432 ESTABLISHED

1. 如果发现服务器没有运行或端口号不正确，可以在PostgreSQL配置文件中修改端口号并重启服务器。在Windows操作系统中，配置文件位于以下路径：

C:\Program Files\PostgreSQL\{版本号}\data\postgresql.conf

打开文件后，找到以下行：

#listen_addresses = 'localhost'
#port = 5432

将#port = 5432的注释去掉，并修改端口号。例如，将端口号修改为8888：

port = 8888

保存文件后，重新启动PostgreSQL服务即可。

PostgreSQL配置文件中没有允许访问该服务器的IP地址

如果PostgreSQL配置文件中没有允许访问该服务器的IP地址，则需要先添加允许访问的IP地址，并在防火墙中开放相应的端口。

在PostgreSQL配置文件中，找到以下行：

#listen_addresses = 'localhost'

将localhost改为*，表示允许任何IP地址访问该服务器。如果只允许特定的IP地址访问，将localhost改为相应的IP地址即可。

保存文件后，重新启动PostgreSQL服务。

如果使用的是防火墙软件，需要打开相应的端口。在Windows防火墙中，可以通过以下步骤添加端口：

1. 进入控制面板，找到“系统与安全”并点击“Windows Defender 防火墙”。

2. 点击“高级设置”，选择“入站规则”，并点击“新建规则”。

3. 选择“端口”，点击“下一步”。

4. 输入端口号，选择协议类型（TCP或UDP），并选择“允许连接”。

5. 输入该规则的名称，例如“PostgreSQL”，并点击“完成”。

防火墙阻止了对该端口的访问

如果使用的是防火墙软件，防火墙可能会阻止对该端口的访问。解决方法可以参考上一节。

示例说明

示例1

在使用pgAdmin连接PostgreSQL时，出现以下错误提示：

FATAL:  could not connect to server: Connection refused (0x0000274D/10061)
Is the server running on host "localhost" (::1) and accepting
TCP/IP connections on port 5432?

这个错误提示表示连接被拒绝。解决方法是检查PostgreSQL服务是否已启动。在Windows操作系统中，可以通过以下步骤启动PostgreSQL服务：

1. 启动pgAdmin，并选择要连接的PostgreSQL服务。

2. 在databases菜单中，选择系统数据库postgres。

3. 右键单击postgres，选择“连接对象菜单”，并点击“连接”。

如果PostgreSQL服务已启动，但仍无法连接，可能是因为防火墙阻止了访问该端口，或PostgreSQL配置文件中没有允许访问该服务器的IP地址。可以参考本文的解决方案一。

示例2

在使用Python连接PostgreSQL时，出现以下错误提示：

OperationalError: FATAL:  role "user" does not exist

这个错误提示表示指定的用户不存在。解决方法是创建新用户或使用已存在的用户。在PostgreSQL中，可以使用以下命令创建新用户：

CREATE USER myuser WITH PASSWORD 'mypassword';

将myuser和mypassword替换为自己的用户名和密码即可。

如果使用的是已存在的用户，则需要检查指定的用户名和密码是否正确。