PostgreSQL Rails：用户的身份验证失败（PG::Error）

在本文中，我们将介绍PostgreSQL与Rails集成时遇到的一个常见问题：”FATAL – Peer authentication failed for user (PG::Error)”。我们将解释这个错误的原因，并提供解决方案和示例代码。

阅读更多：PostgreSQL 教程

1. 问题描述

当我们使用Rails框架与PostgreSQL数据库进行集成时，有时会遇到以下错误信息：

FATAL - Peer authentication failed for user (PG::Error)

这个错误表明在尝试连接到数据库时，由于对等认证失败，PostgreSQL拒绝了用户的身份验证。

2. 错误原因

这个错误通常是由于Rails应用程序在尝试连接到数据库时使用了不正确的身份验证方法引起的。在默认情况下，PostgreSQL的身份验证方法设置为”peer”，这意味着对等认证。这种方式要求操作系统用户的用户名与数据库角色的用户名相匹配。

3. 解决方案

为了解决”FATAL – Peer authentication failed for user”错误，我们可以采取以下几种方法：

方法一：更改身份验证方法

第一种解决方案是更改PostgreSQL的身份验证方法，将其设置为”md5″，这将使用基于密码的身份验证方法。要做到这一点，可以按照以下步骤进行操作：

找到并编辑PostgreSQL的配置文件，通常位于/etc/postgresql/<version>/main/pg_hba.conf。
找到以下行：

   local   all    all    peer
   ```

3. 将这一行改为：

```sql
   local   all    all    md5
   ```

4. 保存并退出配置文件。
5. 重新启动PostgreSQL服务。

此时，应用程序将使用基于密码的身份验证方法连接到数据库，而不再使用对等认证方法。

### 方法二：创建匹配的操作系统用户

第二种解决方案是在操作系统中创建一个与数据库角色匹配的用户。这可以通过以下步骤实现：

1. 在命令行中运行以下命令创建一个新用户（例如，"myappuser"）：

```sql
   sudo adduser myappuser
   ```

2. 在PostgreSQL中创建与该用户匹配的数据库角色：

```sql
   sudo -u postgres createuser -P myappuser
   ```

   这将提示您输入密码。

3. 授予该用户访问所需数据库的权限：

```sql
   sudo -u postgres psql -c "GRANT ALL PRIVILEGES ON DATABASE myappdb TO myappuser;"
   ```

4. 更新Rails应用程序的数据库配置文件（`config/database.yml`），确保使用这个新的用户名和密码进行身份验证。

### 方法三：使用环境变量

第三种解决方案是在Rails应用程序中使用环境变量来传递数据库配置信息。这样可以避免在代码中硬编码敏感信息，如用户名和密码。例如，可以在`config/database.yml`文件中使用以下方式配置：

```yaml
default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  host: <%= ENV['DATABASE_HOST'] %>
  username: <%= ENV['DATABASE_USERNAME'] %>
  password: <%= ENV['DATABASE_PASSWORD'] %>

然后，在部署或本地环境中，可以通过设置相关的环境变量来提供数据库配置信息。

4. 示例代码

以下是一个示例Rails应用程序的数据库配置文件（config/database.yml），使用环境变量来传递数据库配置信息：

default: &default
  adapter: postgresql
  encoding: unicode
  pool: <%= ENV.fetch("RAILS_MAX_THREADS") { 5 } %>
  host: <%= ENV['DATABASE_HOST'] %>
  username: <%= ENV['DATABASE_USERNAME'] %>
  password: <%= ENV['DATABASE_PASSWORD'] %>

development:
  <<: *default
  database: myapp_development

test:
  <<: *default
  database: myapp_test

production:
  <<: *default
  database: myapp_production

总结

在本文中，我们介绍了PostgreSQL与Rails集成时常见的错误：”FATAL – Peer authentication failed for user (PG::Error)”。我们解释了这个错误的原因，并提供了几种解决方案。您可以更改PostgreSQL的身份验证方法，创建匹配的操作系统用户，或者使用环境变量传递数据库配置信息。通过正确处理这个错误，您可以成功连接Rails应用程序与PostgreSQL数据库。