PostgreSQL 在DBeaver（Windows上）中访问PostgreSQL（在wsl2上）失败：”连接被拒绝：connect”

在本文中，我们将介绍如何解决在DBeaver（Windows上）访问postgreSQL（在wsl2上）时出现的”连接被拒绝：connect”错误。

背景

PostgreSQL是一种强大的开源关系数据库系统，被广泛应用于各种应用程序开发和数据管理中。DBeaver是一个流行的数据库管理工具，可用于连接和管理多种数据库系统。

如果您正在使用Windows操作系统，并在wsl2（Windows Subsystem for Linux）上运行PostgreSQL，并尝试使用DBeaver连接到该PostgreSQL实例，但遇到了”连接被拒绝：connect”错误，则本文将为您提供解决方案。

解决方法

以下是解决此问题的一些常见方法：

1. 配置网络

在wsl2中安装和运行的PostgreSQL实例可能无法通过默认的localhost地址访问。这是因为wsl2使用了自己的网络命名空间，并具有自己的IP地址。为了解决此问题，您可以尝试以下方法之一：

方法一：使用wsl2的IP地址连接PostgreSQL。首先，在wsl2终端中运行以下命令：

  ip addr show eth0
  ```
  在输出中，您可以找到wsl2的IP地址。然后，在DBeaver中连接PostgreSQL时，使用此IP地址替代localhost。

- 方法二：将wsl2的IP地址添加到Windows的主机文件中。打开Windows的hosts文件（一般位于C:\Windows\System32\drivers\etc\hosts），并在文件末尾添加以下行：
```sql
  wsl2_ip_address    localhost
  ```
  其中"wsl2_ip_address"是您在第一种方法中找到的wsl2的IP地址。保存修改后的文件并尝试重新连接PostgreSQL。

### 2. 检查端口号
PostgreSQL使用默认端口号5432进行通信。但是，如果您的PostgreSQL实例在wsl2中使用了不同的端口号，则需要在DBeaver中明确指定该端口号。在DBeaver连接设置中，找到端口号选项，并确保与wsl2中的实际端口号一致。

### 3. 防火墙设置
防火墙设置可能会阻止DBeaver与wsl2中的PostgreSQL实例建立连接。请确保在Windows防火墙中允许DBeaver应用程序通过特定端口（默认是5432）进行连接。您可以按照以下步骤操作：

- 打开Windows防火墙设置。
- 点击"高级设置"。
- 在左侧面板中，选择"入站规则"。
- 在右侧面板中，选择"新建规则"。
- 选择"端口"选项，点击"下一步"。
- 选择"特定本地端口"，并输入PostgreSQL实例的端口号（默认是5432）。
- 选择"允许连接"，点击"下一步"。
- 选择"所有网络"，点击"下一步"。
- 输入规则名称（例如"DBeaver PostgreSQL连接"），点击"完成"。

### 4. 检查PostgreSQL配置
确保您的wsl2中的PostgreSQL实例已正确配置，并允许远程连接。请检查以下配置文件：

- 在wsl2中，找到并编辑PostgreSQL的配置文件`postgresql.conf`。一般位于`/etc/postgresql/<version>/main/postgresql.conf`。
- 搜索并确保`listen_addresses`参数已设置为`'*'`。如果未设置，请修改为`'*'`并保存文件。
- 重启PostgreSQL服务。

## 示例
以下是一个示例，演示如何在DBeaver中访问正在运行于wsl2上的PostgreSQL实例。

1. 假设您正在wsl2的Ubuntu环境中运行PostgreSQL，并将其配置为监听端口号5432。确保wsl2的IP地址为`192.168.0.10`。您可以通过运行以下命令来启动PostgreSQL服务：
```sql
sudo service postgresql start

打开DBeaver应用程序，并选择创建新的数据库连接。
在连接设置中，选择PostgreSQL作为数据库类型，并填写以下信息：
- 主机：192.168.0.10
- 端口号：5432
- 数据库：您想要连接的数据库名称
- 用户名和密码：PostgreSQL的有效用户名和密码
点击”测试连接”按钮以验证连接是否成功。
如果一切正常，点击”确定”保存连接设置，并可以开始在DBeaver中使用PostgreSQL。

请注意，这只是一个示例，并且实际配置可能因个人设置而有所不同。根据您的环境和需求，进行相应的调整和配置。

总结

通过适当地配置网络、检查端口号、防火墙设置以及PostgreSQL的配置文件，您可以成功解决在DBeaver中访问正在运行于wsl2上的PostgreSQL实例时出现的”连接被拒绝：connect”错误。请根据您的具体情况选择适用的解决方法，以便您能够顺利地使用DBeaver管理和操作PostgreSQL数据库。