本地调用Serverless函数无法连接Postgres数据库的问题咨询

核心原因 #

是的，Serverless Framework执行sls invoke local时，默认会启动Docker容器模拟Lambda运行环境。容器内的localhost或127.0.0.1指向容器自身，而非你的本地主机——这就是连接被拒绝的原因，而psql直接在主机运行，所以能正常访问。

解决方案 #

1. 替换主机地址（Mac/Windows） #

将数据库连接配置中的host字段改为host.docker.internal，这是Docker官方提供的、用于容器访问主机服务的特殊地址。

2. 使用主机网络模式（Linux） #

Linux系统下Docker不支持host.docker.internal，需在调用时添加网络参数：

sls invoke local --function <function name> --docker-network host

此时容器会共享主机的网络栈，直接用localhost即可访问本地Postgres。

3. 检查Postgres配置（关键） #

确保Postgres允许外部/容器访问：

• 修改postgresql.conf，将listen_addresses设置为*（允许所有地址监听），或包含你的主机局域网IP。
• 修改pg_hba.conf，添加允许容器或主机局域网IP的规则，例如：

  host  all  all  172.17.0.0/16  md5  # Docker默认子网
  

  若使用host模式，保留host all all 127.0.0.1/32 md5即可。

4. 先验证容器到主机的连接 #

用Docker直接测试Postgres连通性，排除Lambda代码问题：

docker run --rm postgres psql -h host.docker.internal -U <你的Postgres用户名> -d <数据库名>

如果能成功连接，再回到Serverless本地调用测试。

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