如何使用Node.js检测SQL数据库是否存在，按需创建或提示连接成功

核心实现思路 #

很多人写这类检测逻辑的时候会踩一个共性的坑：拿着带目标库名的连接参数直接尝试建立连接，一旦库不存在，数据库驱动会直接抛出连接错误，根本没机会执行后续的存在性查询。正确的实现逻辑必须绕开这个问题，先拿到不受目标库存在性影响的稳定连接，再做校验。

分步实现逻辑 #

• 建立系统级兜底连接
  配置连接参数时不要指定目标检测库名，连接到数据库实例默认存在的系统库/根入口：MySQL直接连接服务端根实例即可，PostgreSQL连接默认的postgres系统库，SQL Server连接master系统库。这一步的核心是保证连接本身一定能成功，不受目标库是否存在的影响。
• 执行存在性校验查询
  在合法的系统连接上，查询数据库内置的系统视图，匹配目标库名：
  • MySQL 检测语句：SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = '目标库名'
  • PostgreSQL 检测语句：SELECT datname FROM pg_database WHERE datname = '目标库名'
  • SQL Server 检测语句：SELECT name FROM sys.databases WHERE name = '目标库名'
• 分支处理逻辑
  • 如果查询返回的结果集为空：说明目标库不存在，直接在当前系统连接上执行CREATE DATABASE 目标库名语句完成创建，后续再切换连接指向目标库即可。
  • 如果查询返回了匹配的库名记录：说明目标库已存在，直接调整连接参数绑定目标库，输出连接成功提示。

常见踩坑提醒 #

• 权限校验：执行查询、创建操作的数据库账号，必须拥有访问对应系统视图、创建数据库的权限，否则会因为权限不足查询不到记录，误判为库不存在。
• 不要靠连接报错判断存在性：不少人会写“尝试直连目标库，连接失败就判定库不存在”的逻辑，这种实现的误判率极高——网络不通、密码错误、账号无访问权限都会触发连接失败报错，和目标库是否存在没有必然关联，很容易触发错误的建库流程。
• 大小写匹配：注意不同数据库的库名大小写规则，比如Linux环境下的MySQL库名默认大小写敏感，匹配时要和实际库名的规则对齐，避免误判。

参考实现片段（以mysql2驱动为例） #

const mysql = require('mysql2/promise');

// 建立不带目标库名的系统级连接
const rootConnection = await mysql.createConnection({
  host: '127.0.0.1',
  port: 3306,
  user: 'root',
  password: 'your_db_password'
});

const targetDatabase = 'user_business_db';

// 执行存在性检测
const [existRows] = await rootConnection.execute(
  `SELECT SCHEMA_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = ?`,
  [targetDatabase]
);

if (existRows.length === 0) {
  await rootConnection.execute(`CREATE DATABASE \`${targetDatabase}\` CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci`);
  console.log('目标数据库不存在，已完成自动创建');
} else {
  console.log('目标数据库已存在');
}

// 建立指向目标库的正式业务连接
const businessConnection = await mysql.createConnection({
  host: '127.0.0.1',
  port: 3306,
  user: 'root',
  password: 'your_db_password',
  database: targetDatabase
});
console.log('数据库连接成功');

// 连接用完记得释放资源
await rootConnection.end();

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