WSL中SAM Local API连接PostgreSQL容器超时问题求助

核心原因 #

WSL2的网络架构与Docker容器的网络隔离是问题根源：

• 初始用localhost连接时，SAM Lambda容器的localhost指向容器自身而非WSL主机，因此无法访问PostgreSQL容器
• 改用--docker-network host和host.docker.internal后超时，是因为WSL中host.docker.internal的路由逻辑特殊，加上PostgreSQL容器默认仅监听localhost，导致请求无法正确到达数据库；同时Lambda默认超时时间（3秒）过短，进一步放大了问题

解决方案一：使用自定义Docker网络（推荐） #

让SAM Lambda容器与PostgreSQL容器处于同一自定义网络，直接通过容器名互相访问，规避网络路由问题：

1. 创建自定义Docker网络

docker network create sam-postgres-net

2. 重启PostgreSQL容器并加入该网络（保留端口映射方便WSL终端连接）

docker run --name postgres-db \
  --network sam-postgres-net \
  -p 5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -d postgres

3. 修改SAM启动命令，替换为自定义网络（移除--docker-network host）

sam local start-api --profile my-aws-profile --skip-pull-image --docker-network sam-postgres-net -p 4000 -t template.yaml -n local.env.json

4. 更新数据库连接字符串，主机名改为PostgreSQL容器名称postgres-db

postgresql://postgres:mysecretpassword@postgres-db:5432/postgres?schema=SCHEMA

解决方案二：调整PostgreSQL监听配置与Lambda超时 #

若坚持使用host.docker.internal，需解决PostgreSQL监听限制与Lambda超时问题：

1. 重启PostgreSQL容器，使其监听所有网络地址

docker run --name postgres-db \
  -p 0.0.0.0:5432:5432 \
  -e POSTGRES_PASSWORD=mysecretpassword \
  -d postgres -c listen_addresses='*'

2. 验证WSL中host.docker.internal的连通性

ping host.docker.internal

确保能收到响应，若失败则执行wsl --shutdown后重启WSL，检查网络配置

3. 调整Lambda函数超时时间
   在template.yaml中找到对应Lambda配置，将Timeout设为30秒（可根据实际情况调整）：

Resources:
  YourLambdaFunction:
    Type: AWS::Serverless::Function
    Properties:
      # 其他配置项...
      Timeout: 30

4. 保持修改后的SAM启动命令与连接字符串不变

验证步骤 #

1. 用WSL终端测试PostgreSQL连接，确认数据库正常运行

psql postgresql://postgres:mysecretpassword@localhost:5432/postgres?schema=SCHEMA

2. 启动SAM本地API后，调用接口测试数据库连接是否成功

内容的提问来源于stack exchange，提问作者red house 87