部署在AWS Lambda的Node.js API调用/users路由出现内部服务器错误

你的API在本地serverless-offline环境运行正常，但部署到AWS Lambda后/users路由返回内部服务器错误，核心问题大概率出在Lambda与RDS的网络连通性、运行环境兼容性或数据库连接配置上，以下是具体排查步骤和修复方案：

1. 先获取具体错误信息（最关键步骤） #

当前代码的catch块虽返回了错误消息，但API Gateway可能无法完整传递Lambda的报错细节，你需要直接查看Lambda的CloudWatch日志：

• 登录AWS控制台，进入Lambda服务找到你的hello函数
• 切换到「监控」标签，点击「查看CloudWatch日志」
• 定位对应请求的日志条目，查看具体错误（比如连接超时、权限拒绝、数据库配置错误等）

2. 检查Lambda的VPC访问权限 #

如果你的RDS实例部署在AWS VPC内，默认Lambda函数不在VPC中，无法直接访问RDS：

• 进入Lambda函数的「配置」->「VPC」
• 配置Lambda到RDS所在的VPC子网，并选择允许访问RDS的安全组
• 确保RDS的安全组规则允许Lambda所在安全组的IP访问RDS端口（PostgreSQL默认5432，MySQL默认3306）

3. 验证数据库连接配置 #

本地环境的数据库连接参数可能和生产环境不符：

• 打开connection.js，确认数据库主机地址是RDS的端点地址（可在RDS控制台获取），而非本地的localhost或私有IP
• 建议用AWS Secrets Manager或Lambda环境变量存储数据库用户名、密码等敏感信息，避免硬编码，同时确保Lambda有权限读取这些配置

4. 升级Node.js运行时版本 #

你的serverless.yml中使用的nodejs12.x已被AWS Lambda弃用，可能导致依赖包兼容性问题：
修改serverless.yml的runtime字段：

provider:
  # ...其他配置
  runtime: nodejs18.x # 替换为当前支持的版本，比如18.x或20.x

5. 优化数据库连接处理 #

Lambda是无状态的，每次冷启动可能创建新连接，建议使用连接池避免连接泄漏：
如果使用pg库，修改connection.js为连接池模式：

const { Pool } = require('pg');
const pool = new Pool({
  user: process.env.DB_USER,
  host: process.env.DB_HOST,
  database: process.env.DB_NAME,
  password: process.env.DB_PASSWORD,
  port: process.env.DB_PORT,
});

module.exports = pool;

然后在/users路由中使用连接池查询：

app.get('/users', async function (req, res) {
    try {
        const allProfiles = await pool.query("SELECT * FROM public.portal_users");
        res.status(200).send(allProfiles.rows);  
      } catch (error) {
          console.error('数据库查询错误:', error); // 打印详细错误到CloudWatch
          res.status(500).send("Error received: " + error.message);
      }
  })

额外检查点 #

• 确认Lambda的内存和超时配置足够：当前2048MB内存和15秒超时基本够用，若数据库查询量大可适当调整
• 检查API Gateway的代理配置：/{proxy+}的any方法是否正确转发/users请求，确保无路由匹配问题

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