如何处理Node.js中的致命连接错误：Express连接MariaDB因IP变更引发的连接超时问题

这个问题我之前踩过类似的坑——你已经捕获了getConnection()的Promise错误，但MariaDB连接池本身会抛出一些底层的致命错误（比如连接超时的套接字错误），这些错误没被Promise链覆盖，也没被专门监听的话，Node.js就会把它当作未捕获异常直接终止进程。

核心修复：监听连接池的error事件 #

连接池实例本身会触发error事件，像连接超时这类底层错误，往往不会通过getConnection()的Promise抛出，而是直接触发这个事件。只要给你的MariaPool加上事件监听，就能把这类错误拦下来，避免进程崩溃：

// 先假设你的连接池是这样初始化的
const MariaPool = require('mariadb').createPool({
  host: 'your-db-ip',
  user: 'db-user',
  password: 'db-password',
  database: 'your-db',
  connectionTimeout: 1000 // 和你当前的超时配置一致
});

// 关键：给连接池绑定错误监听
MariaPool.on('error', (err) => {
  console.error('连接池底层错误:', err);
  // 这里可以加日志上报、状态标记等操作，不用重启进程
});

优化请求处理的错误捕获逻辑 #

另外你的原有代码还有几个可以完善的地方，确保所有分支的错误都被覆盖：

app.get("/db", async (req, res) => { 
  console.log("ping to db!") 
  let conn;
  try {
    conn = await MariaPool.getConnection();
    const data = await conn.query("SELECT * FROM devTable");
    console.log(data);
    res.json(data);
  } catch (error) {
    console.error('数据库操作出错:', error);
    // 根据错误类型返回更友好的响应
    if (error.code === 'ER_CONNECTION_TIMEOUT') {
      res.status(503).json({ err: '数据库连接超时，请检查IP或网络' });
    } else if (error.message.includes('Poor SQL format')) {
      res.status(400).json({ err: 'SQL语句格式错误' });
    } else {
      res.status(500).json({ err: '数据库操作失败' });
    }
  } finally {
    // 确保连接被释放，即使过程中出错
    if (conn) {
      try {
        await conn.end();
      } catch (endErr) {
        console.error('释放连接时出错:', endErr);
      }
    }
  }
});

为什么之前的代码拦不住这个错误？ #

你之前的Promise链只捕获了getConnection()和query()的错误，但连接池在尝试创建套接字时的底层超时，并没有通过getConnection()的Promise抛出，而是直接触发了连接池的error事件。Node.js对未监听的error事件默认行为就是终止进程，这才导致了崩溃。

额外小建议 #

如果树莓派经常换网络导致IP变动，可以考虑用动态DNS服务（比如花生壳、No-IP）给它绑定一个固定域名，这样就不用频繁修改代码里的IP地址了。

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