使用express-mysql-session与mysql2创建会话数据库时服务器崩溃问题

核心问题大概率是同步代码中传入了未就绪的异步连接对象——mysql2/promise的连接/连接池是异步获取的，如果直接在同步流程里把未resolved的Promise传给SessionStore，就会导致服务器崩溃（哪怕能生成sessiontbl表，也只是因为表创建逻辑先执行了，但后续连接状态异常引发崩溃）。

下面是具体的解决步骤和代码示例：

1. 用async/await确保连接就绪后再初始化SessionStore #

所有涉及数据库连接的逻辑都要放在异步函数里，等待连接完全建立后再初始化SessionStore：

const express = require('express');
const session = require('express-session');
const MySQLStore = require('express-mysql-session')(session);
const mysql = require('mysql2/promise');

// 把整个服务器启动逻辑包在异步函数里
async function startServer() {
  // 第一步：异步创建并验证连接池
  const pool = mysql.createPool({
    host: 'localhost',
    user: '你的数据库用户名',
    password: '你的数据库密码',
    database: '目标数据库名'
  });

  // 先测试连接是否正常，避免后续崩溃
  try {
    await pool.getConnection();
    console.log('数据库连接池初始化成功');
  } catch (err) {
    console.error('数据库连接失败:', err);
    process.exit(1); // 连接失败直接退出，避免无效启动
  }

  // 第二步：连接就绪后，再初始化SessionStore
  const sessionStore = new MySQLStore(
    { tableName: 'sessiontbl' }, // 对应自动生成的表名
    pool // 传入已就绪的连接池，而非单个连接
  );

  // 给SessionStore添加错误监听，方便排查问题
  sessionStore.on('error', (err) => {
    console.error('Session存储错误:', err);
  });

  // 第三步：初始化Express和Session中间件
  const app = express();
  app.use(session({
    secret: '你的加密密钥',
    resave: false,
    saveUninitialized: false,
    store: sessionStore
  }));

  // 测试路由
  app.get('/', (req, res) => {
    req.session.test = 'session works!';
    res.send('服务器运行正常');
  });

  // 启动服务器
  app.listen(3000, () => {
    console.log('服务器启动在 http://localhost:3000');
  });
}

// 执行启动函数，捕获全局错误
startServer().catch(err => {
  console.error('服务器启动失败:', err);
  process.exit(1);
});

2. 额外排查要点 #

• 不要用单个数据库连接代替连接池：单个连接容易因超时、断开等问题引发崩溃，连接池会自动管理连接状态，稳定性更高。
• 检查sessiontbl的结构：虽然express-mysql-session会自动生成表，但如果之前手动修改过表字段，可能导致兼容性问题，建议删除现有表后让插件重新生成。
• 确认数据库权限：确保你使用的数据库用户拥有对sessiontbl的读、写、创建表权限，权限不足也可能导致隐性崩溃。

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