PostgreSQL 无法连接到本地 PostgreSQL

在本文中，我们将介绍 PostgreSQL 数据库中出现无法连接到本地 PostgreSQL 的常见问题及其解决方法。

阅读更多：SQLite 教程

问题描述

当我们尝试在本地连接到 PostgreSQL 数据库时，可能会遇到以下错误之一：

无法连接到数据库：当尝试使用命令行或应用程序连接到本地 PostgreSQL 数据库时，可能会收到类似”connection refused”（拒绝连接）的错误信息。
权限问题：连接到本地 PostgreSQL 数据库时，可能会遇到”permission denied”（拒绝许可）或”authentication failed”（身份验证失败）的错误。

解决方法

1. 确认 PostgreSQL 服务正在运行

首先，我们需要确认 PostgreSQL 服务正在运行。可以通过以下方法检查：

Windows 用户：

在 Windows 操作系统中，可以通过以下步骤确认 PostgreSQL 服务是否正在运行：

打开任务管理器（可以使用快捷键 Ctrl + Shift + Esc）。
选择”服务”选项卡。
在服务列表中找到 PostgreSQL 服务，并确保其状态为”正在运行”。

Linux / macOS 用户：

在 Linux 或 macOS 操作系统中，可以通过以下命令确认 PostgreSQL 服务是否正在运行：

sudo systemctl status postgresql

如果 PostgreSQL 服务没有在运行，可以使用以下命令启动它：

sudo systemctl start postgresql

2. 检查连接参数

如果 PostgreSQL 服务正在运行，但仍然无法连接到本地数据库，可能是因为连接参数配置不正确。请尝试以下步骤：

2.1 检查主机和端口号

在连接字符串中确认主机名和端口号与 PostgreSQL 配置文件中的设置相匹配。默认情况下，PostgreSQL 使用 localhost 作为主机名，端口号为 5432。

import psycopg2

try:
    connection = psycopg2.connect(
        host="localhost",
        port="5432",
        user="your_username",
        password="your_password",
        database="your_database"
    )
    cursor = connection.cursor()
    print("Connected to PostgreSQL successfully!")
    cursor.close()
    connection.close()

except psycopg2.Error as error:
    print("Failed to connect to PostgreSQL", error)

2.2 检查用户名和密码

确认用户名和密码是否正确，并与 PostgreSQL 数据库中的设置相匹配。

import psycopg2

try:
    connection = psycopg2.connect(
        host="localhost",
        port="5432",
        user="your_username",
        password="your_password",
        database="your_database"
    )
    cursor = connection.cursor()
    print("Connected to PostgreSQL successfully!")
    cursor.close()
    connection.close()

except psycopg2.Error as error:
    print("Failed to connect to PostgreSQL", error)

3. 配置文件检查

确定 PostgreSQL 配置文件中的参数是否正确配置。根据操作系统的不同，配置文件的位置也有所不同。通常，可以在以下位置找到配置文件：

Windows: C:\Program Files\PostgreSQL\version\data\postgresql.conf
Linux: /etc/postgresql/version/main/postgresql.conf
macOS: /usr/local/var/postgres/postgresql.conf

确保以下参数正确配置：

`listen_addresses`

此参数指定 PostgreSQL 监听的 IP 地址。如果设置为*，则允许任何客户端连接。如果设置为localhost，则只允许本地连接。如果设置为其他特定 IP 地址，则只允许该 IP 地址的客户端连接。

listen_addresses = '*'

`port`

此参数指定 PostgreSQL 监听的端口号。默认为 5432。

port = 5432

`max_connections`

此参数指定 PostgreSQL 数据库可以同时处理的最大连接数。增加此值可能有助于解决连接超过最大限制的问题。

max_connections = 100

总结

在本文中，我们介绍了解决连接不到本地 PostgreSQL 数据库的常见问题的方法。首先，我们确保 PostgreSQL 服务正在运行，并检查连接参数的正确性。如果问题仍然存在，我们可以检查配置文件以确保正确配置。通过按照这些步骤进行排查，我们可以解决连接问题，顺利地连接到本地 PostgreSQL 数据库。