GCP函数连接PostgreSQL报Could not handle the request排查

你遇到的60秒超时、返回Error: could not handle the request和业务代码逻辑无关——相同代码本地可正常运行已经排除了SQL语法、账号密码、pg依赖用法错误的可能。核心问题出在网络连通性、GCP函数和Express的适配写法两个层面，单纯调大函数超时阈值没有任何作用，因为请求从一开始就没正常建立数据库连接，等再久也不会有返回。

按以下顺序排查修复：

• 先解决网络连通性问题
  本地能连通数据库，是因为你本地的公网出口IP已经加在PostgreSQL的安全组/防火墙入站白名单里，但GCP Cloud Function默认使用动态公网出口IP，地址不固定，数据库侧会直接丢弃来自未知IP的连接请求，导致连接挂起直到超时。
  快速验证方法：临时把PostgreSQL的入站规则放开0.0.0.0/0（仅用于验证，测试完成立刻关闭，避免数据库暴露在公网），如果此时函数能正常返回结果，就可以确认是白名单问题。生产环境需要给函数配置VPC连接器+静态NAT网关，绑定固定公网出口IP后，把这个固定IP加到数据库白名单即可。
• 修正Express和GCP函数的适配写法
  你当前直接导出express实例的写法不符合GCP HTTP函数的入口规范，函数运行时不会自动启动express服务监听请求，需要用serverless-http做一层适配。
• 优化数据库连接池配置
  无服务器环境下不要用默认的连接池配置，要加显式的连接超时、空闲释放规则，避免连接挂死耗尽资源。

首先安装缺失的依赖：

npm install pg serverless-http

替换函数代码为以下内容，部署时把入口函数名设置为app：

const express = require('express');
const serverless = require('serverless-http');
const app = express();
const { Pool } = require('pg');

const pool = new Pool({
  user: 'postgres',
  host: 'xx.xxx.xx.xxx',
  database: 'postgres',
  password: 'mypasswordxxxx',
  port: 5432,
  connectionTimeoutMillis: 5000, // 连接5秒失败直接抛错，不要空等60秒
  idleTimeoutMillis: 10000, // 空闲连接10秒自动释放
  max: 1 // 单函数实例仅保留1个连接，避免打满数据库连接数
});

app.get('/', (req, res) => {
  pool.query('SELECT * FROM leads', (error, results) => {
    if (error) {
      console.error('数据库查询异常:', error);
      return res.status(500).json({ error: error.message });
    }
    res.status(200).json(results.rows);
  });
});

// 适配GCP函数运行时入口
exports.app = serverless(app);

部署注意事项：

1. 确认函数运行时绑定的服务账号开启了公网访问权限，如果配置了VPC全量路由，要确认VPC到数据库公网IP的路由、防火墙规则放通
2. 白名单验证完成后立刻收回0.0.0.0/0的放开规则，避免数据库被公网扫描攻击
3. 如果你的PostgreSQL本身部署在GCP同VPC内，直接用VPC内网地址连接，不需要走公网，延迟更低也更安全

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