Express服务器连接MariaDB出现连接池超时错误求助

以下是针对你遇到的连接池获取超时问题的排查和解决步骤：

1. 调整连接池核心配置参数 #

你遇到的是从连接池获取连接超时，而非单个连接建立超时，仅修改connectTimeout无法解决。需要重点调整以下参数：

• connectionLimit：连接池最大连接数，避免设置过小导致无可用连接
• acquireTimeout：从池内获取连接的超时时间，适当调大（比如60000ms）
• idleTimeout：空闲连接的回收时间，防止池内堆积无效连接

示例配置：

const mariadb = require('mariadb');
const pool = mariadb.createPool({
  host: '你的数据库地址',
  user: '数据库账号',
  password: '数据库密码',
  database: '目标库名',
  connectionLimit: 10,
  acquireTimeout: 60000,
  idleTimeout: 30000,
  connectTimeout: 10000
});

2. 排查未正确释放的连接 #

连接池耗尽最常见的原因是代码未将连接放回池内，比如误用conn.end()（销毁连接）而非conn.release()（释放回池）。

错误示例：

// 错误：销毁连接导致池内连接持续减少
pool.getConnection().then(conn => {
  conn.query("SELECT * FROM users WHERE username=?", [req.body.username])
    .then(res => {
      conn.end(); // 此处应改为conn.release()
    })
    .catch(err => {
      conn.end();
    });
});

正确写法（推荐用async/await+try/finally确保释放）：

async function handleLogin(req, res) {
  let conn;
  try {
    conn = await pool.getConnection();
    const user = await conn.query("SELECT * FROM users WHERE username=?", [req.body.username]);
    // 登录逻辑处理
  } catch (err) {
    res.status(500).send('登录失败');
  } finally {
    if (conn) conn.release(); // 无论成功失败，都将连接放回池
  }
}

3. 检查MariaDB全局连接限制 #

OpenSuse上的MariaDB默认最大连接数可能不足以支撑你的连接池需求，执行以下SQL查看当前限制：

SHOW VARIABLES LIKE 'max_connections';

如果值过小（比如默认100），修改/etc/my.cnf（或/etc/mysql/my.cnf）添加配置：

[mysqld]
max_connections = 200

重启MariaDB服务生效：

sudo systemctl restart mariadb

4. 排查防火墙/SELinux限制 #

虽然控制台能连接，但Express进程可能被防火墙或SELinux拦截：

• 临时关闭防火墙测试：

  sudo systemctl stop firewalld
  

  若恢复正常，添加3306端口允许规则：

  sudo firewall-cmd --add-port=3306/tcp --permanent
  sudo firewall-cmd --reload
  

• 检查SELinux状态：

  sestatus
  

  若为Enforcing模式，临时设置为Permissive测试：

  sudo setenforce 0
  

  有效则配置SELinux允许Node进程连接数据库：

  sudo setsebool -P httpd_can_network_connect_db 1
  

5. 确认MariaDB绑定地址 #

确保MariaDB未仅绑定127.0.0.1（若Express与DB同机器则无需修改，否则需调整）：
修改my.cnf中的bind-address为0.0.0.0或服务器公网IP：

[mysqld]
bind-address = 0.0.0.0

重启MariaDB服务后测试连接。

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