Node.js调用DigitalOcean MySQL集群查询遇undefined及ETIMEDOUT问题

先处理「Error: connect ETIMEDOUT」连接超时问题 #

这个问题核心是你的Node.js服务无法和DigitalOcean数据库集群建立网络连接，按以下步骤排查：

• 检查数据库防火墙规则：登录DigitalOcean控制台，找到目标数据库集群，进入「Connections」标签页，将Node.js服务的公网IP（本地开发则填当前网络的公网IP）添加到「Trusted Sources」列表。开发环境临时测试可添加0.0.0.0/0，但生产环境绝对禁止这么做。
• 核对连接参数：确保代码里的host是DigitalOcean提供的集群域名（格式类似db-cluster-xxx-do-user-xxxxxx-0.b.db.ondigitalocean.com，不是单纯IP），port匹配数据库类型（PostgreSQL默认5432，MySQL默认3306），user、password、database完全和控制台配置一致。
• 排查网络环境：本地开发时关闭VPN或代理重试；服务器部署的话，检查服务器防火墙是否放行对应端口的出站请求（比如5432端口）。
• 客户端工具验证：用pgAdmin（PostgreSQL）或MySQL Workbench，用相同参数尝试连接，能连上说明是代码问题，连不上则是网络或配置问题。

再处理查询返回undefined的问题 #

假设你用的是pg或mysql2这类常用库，常见原因和解决方法：

• 回调未处理错误：初始代码若用回调模式，没判断错误就打印结果，出错时res会是undefined。正确写法：

const { Client } = require('pg');
const client = new Client({ /* 你的连接参数 */ });

client.connect();
client.query('SELECT * FROM your_table', (err, res) => {
  if (err) {
    console.error('查询出错:', err);
    return;
  }
  console.log('查询结果:', res.rows);
  client.end();
});

• Promise封装逻辑错误：自行封装Promise时，要确保回调里正确触发resolve和reject：

const { Client } = require('pg');
const client = new Client({ /* 你的连接参数 */ });
client.connect();

function runQuery(sql) {
  return new Promise((resolve, reject) => {
    client.query(sql, (err, res) => {
      if (err) reject(err);
      else resolve(res.rows);
    });
  });
}

async function fetchData() {
  try {
    const data = await runQuery('SELECT * FROM your_table');
    console.log(data);
  } catch (err) {
    console.error(err);
  } finally {
    client.end();
  }
}

fetchData();

• 未正确初始化连接：如果没调用client.connect()就执行查询，或连接未建立就发起请求，也会返回undefined。建议用连接池替代单个客户端，避免手动管理连接的问题：

const { Pool } = require('pg');
const pool = new Pool({ /* 你的连接参数 */ });

async function fetchData() {
  const res = await pool.query('SELECT * FROM your_table');
  console.log(res.rows);
  await pool.end();
}

fetchData();

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