Google Cloud App Engine(Node.js)连接MySQL报connect ETIMEDOUT错误求助

看起来你遇到的是典型的数据库连接超时问题，结合GCP App Engine的环境特性，我从几个关键方向给你排查建议：

1. 优先排查GCP环境的网络连通性 #

如果你的MySQL是Google Cloud SQL实例，这是最容易踩坑的点：

• 不要用TCP IP直接连接（除非你必须）：App Engine标准环境的出站IP是动态变化的，你很难把所有可能的IP都加到Cloud SQL的授权网络里。推荐用Cloud SQL Unix Socket连接，更稳定且无需授权IP。配置方式是把连接参数里的host换成socketPath，值为你的Cloud SQL实例连接名（格式：项目ID:区域:实例名）：

  var connection = mysql.createPool ({
    socketPath: '/cloudsql/your-project-id:us-central1:your-sql-instance',
    user : 'root',
    connectionLimit : 20, // 后面会说为什么调低这个值
    password : 'the_password',
    database : 'the_dbname',
    charset : 'utf8mb4'
  });
  

• 检查服务账号权限：确保App Engine的默认服务账号拥有Cloud SQL Client角色，否则连不上Cloud SQL实例。你可以在GCP控制台的IAM页面找到对应的服务账号，添加这个角色。
• 如果是自建MySQL服务器：要确保服务器的防火墙开放了3306端口，并且允许App Engine的出站IP段访问（可以查GCP官方文档里App Engine的IP范围）。

2. 调整连接池配置，避免资源耗尽 #

你设置的connectionLimit: 1000太夸张了：

• App Engine每个实例的资源（CPU、内存）有限，1000个并发连接完全超出实例承载能力，会导致连接排队超时。
• MySQL默认的max_connections通常在100-200之间，你设置1000会直接被MySQL拒绝连接。
  建议把connectionLimit调低到10-20，同时添加超时参数避免连接挂起：

var connection = mysql.createPool ({
  // 其他参数...
  connectionLimit : 20,
  acquireTimeout: 60000, // 60秒内获取不到连接就超时
  timeout: 60000, // 连接闲置60秒就自动释放
  waitForConnections: true // 连接池满时等待，而不是直接报错
});

3. 完善代码的错误处理，避免连接泄漏 #

你的代码里有两个容易导致连接泄漏的问题：

• getConnection出错时未终止流程：如果获取连接失败，代码会继续往下执行，可能导致后续逻辑混乱。要加上return终止：

  db.getConnection(function(err, connection) {
    if (err) {
      console.log("Connection ERROR:", err);
      return; // 这里必须return，避免后续执行
    } 
    // 后续查询逻辑
  });
  

• 查询出错时未释放连接：你现在是先释放连接再处理错误，但如果查询出错，一定要确保连接被释放（其实不管成功失败都要释放），调整顺序更稳妥：

  connection.query('SELECT * FROM `my_table_name`', function (error, results, fields) {
    // 不管查询成功还是失败，先释放连接
    connection.release();
    
    if (error) {
      console.log("QUERY ERROR:", error);
      return;
    }
    
    console.log("Results:", results);
    console.log("FIELDS:", fields);
  });
  

4. 额外排查点 #

• 检查MySQL服务器的负载：如果服务器CPU、内存占用过高，也会导致连接超时，可以在GCP控制台（Cloud SQL）或者自建服务器的监控工具里查看。
• 测试本地连接：如果本地能正常连接到MySQL，那问题大概率出在GCP的网络配置或者App Engine的环境限制上。

先从这几个方向排查，应该能解决你的ETIMEDOUT问题。

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