Cloud Function无法连接Cloud SQL求助（附Node.js代码及报错信息）

你遇到的这两个连接错误是Cloud SQL和Node.js集成时的常见问题，我来一步步帮你排查解决：

一、先搞定ETIMEDOUT（公网IP连接超时） #

用公网IP连接时超时，基本是网络层面的拦截，按下面的步骤检查：

• 确认Cloud SQL公网访问和IP白名单：打开GCP控制台的Cloud SQL实例详情页，在「连接」标签里，先确保「公网IP」是启用状态；然后把你的客户端IP（本地开发就是你电脑的公网IP，云服务的话就是服务的出口IP）添加到「授权网络」列表里，没加的话肯定连不上。
• 检查防火墙规则：本地开发的话，看看电脑防火墙有没有阻止3306端口的出站请求；如果是在云服务器上跑代码，检查VPC防火墙是否允许访问Cloud SQL的公网IP和3306端口。
• 核对IP和端口：别写错Cloud SQL的公网IP，默认端口是3306，要是你改了端口记得同步到代码里。

二、解决ECONNREFUSED（Socket连接被拒绝） #

换成socketPath后被拒绝，大概率是路径配置错了或者环境权限有问题：

• 复制正确的实例连接名称：project-id:region-name:instance这个格式必须丝毫不差，直接去Cloud SQL实例详情页的「连接」标签里复制「实例连接名称」，别手动敲，容易写错项目ID或者实例名。
• 分环境检查配置：
  • 如果代码跑在GCP托管服务（比如Cloud Functions、App Engine、GKE）：首先得给服务账号配上Cloud SQL Client角色；然后部署的时候要关联Cloud SQL实例，比如Cloud Functions部署时加--add-cloudsql-instances=你的实例连接名称参数，或者在控制台的函数配置里直接选要关联的实例。
  • 如果是本地开发：必须先启动Cloud SQL代理！代理启动命令大概是这样的：

    ./cloud-sql-proxy 你的实例连接名称
    

    代理默认会在/cloudsql/目录下生成socket文件，代码里的socketPath要和这个路径一致。Windows系统的话路径格式不一样，得注意调整。
• 检查文件权限：运行Node.js的用户得有权限访问/cloudsql/目录和里面的socket文件，Linux/macOS下如果报错，试试用sudo启动Node进程，或者调整目录权限。

三、代码里的小坑要注意 #

另外你的代码还有个异步逻辑问题：con.end()放在了con.query()外面，这会导致连接在查询还没执行完就被关掉，可能引发其他奇怪的错误。把con.end()移到查询的回调里才对，比如：

con.query(`SELECT now()`, null, function (err, result) {
  console.log("Query Error - " + err)
  if (err) throw err;
  console.log("Result: " + result);
  // 查询完再关连接
  con.end();
  res.status(200).send('Acknowledgement : ' + req.body.message);
});
// 这里别放con.end()！

按上面的步骤逐一排查，应该就能解决连接问题了。

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