Ruby Sinatra部署AWS Lambda后无法连接RDS PostgreSQL求助

问题场景 #

本地开发环境可正常连接AWS RDS PostgreSQL，但部署到Lambda后访问数据库时出现以下错误：

ActiveRecord::ConnectionNotEstablished - connection to server on socket "/var/run/postgresql/.s.PGSQL.5432" failed: No such file or directory
Is the server running locally and accepting connections on that socket?
:
/var/task/vendor/bundle/ruby/3.2.0/gems/activerecord-7.1.1/lib/active_record/connection_adapters/postgresql_adapter.rb:80:in `rescue in new_client'

附database.yml配置：

default: &default
  adapter: postgresql
  pool: 5
  timeout: 5000

test:
  <<: *default
  database: test

development:
  <<: *default
  host: <%= ENV['DATABASE_HOST'] %>
  database: <%= ENV['DATABASE_NAME'] %>
  username: <%= ENV['DATABASE_USER'] %>
  password: <%= ENV['DATABASE_PASSWORD'] %>

排查方向 #

1. 确认Lambda运行的数据库环境配置 #

Lambda默认运行在生产环境（RACK_ENV=production或RAILS_ENV=production），但你的database.yml仅配置了development环境。当应用找不到对应环境的配置时，会 fallback到默认配置，而默认配置没有指定host，ActiveRecord会尝试连接本地PostgreSQL socket，从而触发错误。

• 解决：在database.yml中添加production环境配置，复制development的配置内容；或者修改默认配置块，将host、database等变量引用移到&default中，确保所有环境都能读取RDS连接信息。

2. 验证Lambda环境变量是否正确 #

本地能正常连接是因为本地环境变量配置正确，但Lambda的环境变量可能未设置或存在拼写错误：

• 检查Lambda函数的环境变量面板，确认DATABASE_HOST、DATABASE_NAME、DATABASE_USER、DATABASE_PASSWORD已正确配置。
• 可在代码中添加日志输出（比如puts ENV['DATABASE_HOST']），验证Lambda是否能读取到这些变量。

3. 检查pg gem的打包兼容性 #

如果在非Linux环境（比如MacOS）本地打包依赖，pg gem会编译为对应系统的版本，而Lambda运行在Amazon Linux环境，跨系统编译的gem可能无法正常建立TCP连接，进而 fallback到本地socket：

• 解决：使用Lambda层管理pg gem，或者在与Lambda相同的Linux环境下打包依赖（比如用Docker运行Amazon Linux镜像，在容器内执行bundle install --deployment），确保依赖是针对Linux编译的。

4. 排查VPC与网络连通性 #

即使Lambda和RDS都能访问互联网，仍需确认网络连通性：

• 检查RDS安全组是否允许Lambda的访问源（Lambda的公网IP或所在安全组）访问5432端口。如果Lambda是公网访问，可临时将RDS安全组的5432端口开放到0.0.0.0/0用于测试（测试后关闭）。
• 若Lambda配置了VPC，需确认子网路由表是否有到互联网的路由（比如通过NAT网关），确保Lambda能访问RDS的公网地址。
• 可在Lambda中添加简单测试代码（比如用Ruby的TCPSocket.new(ENV['DATABASE_HOST'], 5432)），验证端口是否能连通。

问题根源初步判断 #

从错误信息来看，优先排查配置问题（环境指定错误或环境变量缺失），这是导致应用尝试连接本地socket的直接原因。pg gem打包问题和网络问题可能在配置修正后出现，但当前错误的核心是未正确加载RDS的连接参数。

内容的提问来源于stack exchange，提问作者Alvaro