NodeJS连接SQL Server查询超时问题排查求助

核心问题分析 #

你的场景中，简单的SELECT TOP (1)查询正常，但带LIKE %xxx%的查询超时，主要原因有两个：

1. 连接池使用错误：每次请求都重复打开和关闭连接池，完全违背连接池复用连接的设计，额外增加了数据库连接开销
2. LIKE通配符导致索引失效：%前缀的LIKE查询无法使用Email字段的常规索引，触发全表扫描，数据量大时必然超时

解决方案步骤 #

1. 修复连接池的错误使用

连接池应该在服务启动时初始化一次，后续请求直接复用连接，不要每次请求都执行connect()和close()。修改后的代码如下：

const express = require('express');
const mssql = require('mssql');

const app = express();
const PORT = process.env.PORT || 5999;

const config = {
  user: 'redacted',
  password: 'redacted',
  server: 'redacted',
  database: 'redacted',
  options: {
    encrypt: true,
    enableArithAbort: true,
  },
};

const pool = new mssql.ConnectionPool(config);

// 服务启动时初始化连接池，仅执行一次
pool.connect()
  .then(() => console.log('数据库连接池初始化完成'))
  .catch(err => console.error('连接池初始化失败:', err));

app.use(express.json());

app.get('/api/search', async (req, res) => {
  const searchTerm = req.query.term;

  try {
    const testResult = await pool.request().query('SELECT TOP (1) * FROM [dbo].[TableName1]');
    console.log('测试查询结果:', testResult.recordset);

    const result = await pool
      .request()
      .input('searchTerm', mssql.NVarChar(300), `%${searchTerm}%`)
      .query('SELECT * FROM [dbo].[TableName1] WHERE Email LIKE @searchTerm');
    
    console.log('查询输出:', result.recordset);
    res.json(result.recordset);
  } catch (error) {
    console.error('查询执行错误:', error);
    res.status(500).send('内部服务器错误');
  }
  // 移除finally中的pool.close()，连接池保持复用
});

app.listen(PORT, () => {
  console.log(`服务器运行在 http://localhost:${PORT}`);
});

2. 优化LIKE查询性能

%xxx%的前后通配符会导致常规索引失效，针对不同场景选择优化方案：

• 如果仅需前缀匹配：比如查询xxx%，直接给Email字段创建非聚集索引：

  CREATE NONCLUSTERED INDEX IX_TableName1_Email ON [dbo].[TableName1](Email);
  

• 必须使用前后通配符：

  1. 使用全文索引（推荐）：
     先在数据库中启用全文索引，然后给TableName1的Email字段创建全文索引，之后用CONTAINS替代LIKE：

     SELECT * FROM [dbo].[TableName1] WHERE CONTAINS(Email, @searchTerm);
     

     注意：全文索引的查询语法和LIKE不同，不需要手动加%，SQL Server会自动处理模糊匹配。
  2. 限制返回行数：如果不需要返回所有匹配结果，添加TOP N减少数据传输量：

     SELECT TOP 100 * FROM [dbo].[TableName1] WHERE Email LIKE @searchTerm;
     

  3. 临时增加超时时间：仅作为临时排查方案，不推荐长期使用：

     const result = await pool
       .request()
       .timeout(30000) // 设置30秒超时，默认是15秒
       .input('searchTerm', mssql.NVarChar(300), `%${searchTerm}%`)
       .query('SELECT * FROM [dbo].[TableName1] WHERE Email LIKE @searchTerm');
     

3. 数据库层面排查

• 直接在SQL Server Management Studio（SSMS）中执行相同的LIKE查询，确认是否是数据库本身性能问题
• 查看TableName1的行数，如果数据量超过10万级，全表扫描必然超时，必须依赖索引优化
• 检查数据库服务器的CPU、内存使用率，排除服务器资源不足导致的超时

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