Node.js连接SQL Server报错：Global connection already exists 解决方案咨询

这个问题我之前处理过好多次，本质是你在mssql库中重复调用了全局的connect()方法，但之前的连接还没关闭。下面给你几个靠谱的解决思路，按推荐程度排序：

1. 优先使用连接池（最推荐） #

连接池是生产环境的最佳实践，它会自动管理连接的创建和复用，根本不会出现重复连接的问题。

实现步骤： #

• 在你的DatabaseConfig.js里配置连接池：

const sql = require('mssql');

const poolConfig = {
  user: 'your_username',
  password: 'your_password',
  server: 'your_server',
  database: 'your_db',
  pool: {
    max: 10, // 最大连接数
    min: 0,
    idleTimeoutMillis: 30000
  },
  options: {
    encrypt: true, // 如果是Azure SQL需要开启
    trustServerCertificate: true // 本地开发可以开启，生产环境建议关闭
  }
};

// 创建全局连接池实例
const pool = new sql.ConnectionPool(poolConfig);
const poolConnect = pool.connect();

module.exports = {
  sql,
  pool,
  poolConnect
};

• 在Model层里使用连接池执行查询：

const { sql, pool, poolConnect } = require('../DatabaseConfig');

async function getSomeData() {
  await poolConnect; // 确保连接池已连接
  try {
    const request = pool.request();
    const result = await request.query('SELECT * FROM YourTable');
    return result.recordset;
  } catch (err) {
    throw err;
  }
}

module.exports = { getSomeData };

这样每次查询都会复用连接池里的空闲连接，不需要手动关闭，连接池会自动处理。

2. 复用单个全局连接（适合小型项目） #

如果你的项目规模不大，也可以只创建一次全局连接，之后所有查询都用这个连接，不要重复调用connect()。

实现步骤： #

• 修改DatabaseConfig.js：

const sql = require('mssql');

const config = {
  // 你的数据库配置参数
  user: 'your_username',
  password: 'your_password',
  server: 'your_server',
  database: 'your_db',
  options: {
    encrypt: true,
    trustServerCertificate: true
  }
};

// 只创建一次连接
let connection;

async function getConnection() {
  if (!connection || connection.state === 'closed') {
    connection = await sql.connect(config);
  }
  return connection;
}

module.exports = { sql, getConnection };

• 在Model层使用：

const { sql, getConnection } = require('../DatabaseConfig');

async function getSomeData() {
  const connection = await getConnection();
  try {
    const request = connection.request();
    const result = await request.query('SELECT * FROM YourTable');
    return result.recordset;
  } catch (err) {
    throw err;
  }
}

注意：如果你的应用需要长期运行，要处理连接断开的情况，比如监听error事件重新连接。

3. 每次查询后手动关闭连接（不推荐，影响性能） #

如果你一定要每次查询都创建新连接，那必须确保每次查询完成后关闭连接，包括异常情况。

示例代码： #

const sql = require('mssql');
const config = require('../DatabaseConfig');

async function getSomeData() {
  let connection;
  try {
    connection = await sql.connect(config);
    const request = connection.request();
    const result = await request.query('SELECT * FROM YourTable');
    return result.recordset;
  } catch (err) {
    throw err;
  } finally {
    // 不管成功还是失败，都关闭连接
    if (connection) {
      await connection.close();
    }
  }
}

这种方式每次查询都要创建和关闭连接，性能很差，只适合临时脚本或者测试场景。

排查小技巧 #

• 检查你的代码里是不是在多个地方调用了sql.connect()，比如不同的Model文件里都单独调用了，这就会导致重复连接。
• 如果之前用了全局连接，现在要切换到连接池，记得先调用sql.close()关闭之前的全局连接，避免启动时出错。

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