Conexión y uso de MySQL con Node.js
MySQL es una de las bases de datos relacionales de código abierto más populares, y Node.js es un entorno de ejecución de JavaScript basado en el motor Chrome V8. Combinar ambos permite construir potentes servicios backend.
¿Por qué elegir MySQL + Node.js?
- MySQL ofrece almacenamiento y gestión de datos confiables
- El modelo de E/S no bloqueante de Node.js es adecuado para operaciones de base de datos
- Desarrollo full-stack con JavaScript (mismo lenguaje en frontend y backend)
- El ecosistema npm tiene muchos paquetes relacionados con MySQL
Instalación de dependencias necesarias
Antes de comenzar, necesitamos instalarmysql2paquete, que es una opción popular para conectar MySQL en Node.js.
npm install mysql2
¿Por qué elegir mysql2 en lugar de mysql?
- Mejor rendimiento
- Soporte para la API de Promise
- Soporte para sentencias preparadas
- Mantenimiento activo
Establecer conexión a la base de datos
Configuración básica de conexión
Ejemplo
const mysql = require('mysql2');
// Crear grupo de conexiones (recomendado para producción)
const pool = mysql.createPool({
host: 'localhost', // Dirección del servidor de base de datos
user: 'root', // Nombre de usuario de la base de datos
password: 'password', // Contraseña de la base de datos
database: 'test_db', // Nombre de la base de datos a conectar
waitForConnections: true,
connectionLimit: 10, // Número máximo de conexiones del pool de conexiones
queueLimit: 0
});
// Obtener una versión Promise de la conexión
const promisePool = pool.promise();
// Crear grupo de conexiones (recomendado para producción)
const pool = mysql.createPool({
host: 'localhost', // Dirección del servidor de base de datos
user: 'root', // Nombre de usuario de la base de datos
password: 'password', // Contraseña de la base de datos
database: 'test_db', // Nombre de la base de datos a conectar
waitForConnections: true,
connectionLimit: 10, // Número máximo de conexiones del pool de conexiones
queueLimit: 0
});
// Obtener una versión Promise de la conexión
const promisePool = pool.promise();
Pool de conexiones vs conexión única
Ventajas del pool de conexiones:
- Reutilizar conexiones, reduciendo la sobrecarga
- Gestionar automáticamente el ciclo de vida de las conexiones
- Prevenir fugas de conexiones
- Mejor rendimiento
Escenarios adecuados para conexión única:
- Scripts simples
- Entorno de pruebas
- Aplicaciones de baja concurrencia
Ejecutar operaciones CRUD básicas
Consultar datos (SELECT)
Ejemplo
async function getUsers() {
try {
const [rows, fields] = await promisePool.query('SELECT * FROM users');
console.log(rows);
return rows;
} catch (err) {
console.error('Error de consulta:', err);
throw err;
}
}
try {
const [rows, fields] = await promisePool.query('SELECT * FROM users');
console.log(rows);
return rows;
} catch (err) {
console.error('Error de consulta:', err);
throw err;
}
}
Insertar datos (INSERT)
Ejemplo
async function addUser(user) {
try {
const [result] = await promisePool.query(
'INSERT INTO users (name, email) VALUES (?, ?)',
[user.name, user.email]
);
console.log('ID de inserción:', result.insertId);
return result;
} catch (err) {
console.error('Error de inserción:', err);
throw err;
}
}
try {
const [result] = await promisePool.query(
'INSERT INTO users (name, email) VALUES (?, ?)',
[user.name, user.email]
);
console.log('ID de inserción:', result.insertId);
return result;
} catch (err) {
console.error('Error de inserción:', err);
throw err;
}
}
Actualizar datos (UPDATE)
Ejemplo
async function updateUser(id, updates) {
try {
const [result] = await promisePool.query(
'UPDATE users SET name = ?, email = ? WHERE id = ?',
[updates.name, updates.email, id]
);
console.log('Filas afectadas:', result.affectedRows);
return result;
} catch (err) {
console.error('Error de actualización:', err);
throw err;
}
}
try {
const [result] = await promisePool.query(
'UPDATE users SET name = ?, email = ? WHERE id = ?',
[updates.name, updates.email, id]
);
console.log('Filas afectadas:', result.affectedRows);
return result;
} catch (err) {
console.error('Error de actualización:', err);
throw err;
}
}
Eliminar datos (DELETE)
Ejemplo
async function deleteUser(id) {
try {
const [result] = await promisePool.query(
'DELETE FROM users WHERE id = ?',
[id]
);
console.log('Filas eliminadas:', result.affectedRows);
return result;
} catch (err) {
console.error('Error de eliminación:', err);
throw err;
}
}
try {
const [result] = await promisePool.query(
'DELETE FROM users WHERE id = ?',
[id]
);
console.log('Filas eliminadas:', result.affectedRows);
return result;
} catch (err) {
console.error('Error de eliminación:', err);
throw err;
}
}
Funciones avanzadas y mejores prácticas
Manejo de transacciones
Ejemplo
async function transferFunds(fromId, toId, amount) {
let connection;
try {
// Obtener una conexión del pool de conexiones
connection = await promisePool.getConnection();
// Iniciar transacción
await connection.beginTransaction();
// Ejecutar la operación de transferencia
await connection.query(
'UPDATE accounts SET balance = balance - ? WHERE id = ?',
[amount, fromId]
);
await connection.query(
'UPDATE accounts SET balance = balance + ? WHERE id = ?',
[amount, toId]
);
// Confirmar transacción
await connection.commit();
console.log('Transferencia exitosa');
} catch (err) {
// Revertir en caso de error
if (connection) await connection.rollback();
console.error('Error de transferencia:', err);
throw err;
} finally {
// Devolver la conexión al pool de conexiones
if (connection) connection.release();
}
}
let connection;
try {
// Obtener una conexión del pool de conexiones
connection = await promisePool.getConnection();
// Iniciar transacción
await connection.beginTransaction();
// Ejecutar la operación de transferencia
await connection.query(
'UPDATE accounts SET balance = balance - ? WHERE id = ?',
[amount, fromId]
);
await connection.query(
'UPDATE accounts SET balance = balance + ? WHERE id = ?',
[amount, toId]
);
// Confirmar transacción
await connection.commit();
console.log('Transferencia exitosa');
} catch (err) {
// Revertir en caso de error
if (connection) await connection.rollback();
console.error('Error de transferencia:', err);
throw err;
} finally {
// Devolver la conexión al pool de conexiones
if (connection) connection.release();
}
}
Sentencias preparadas
Las sentencias preparadas pueden mejorar el rendimiento y prevenir la inyección SQL:
Ejemplo
async function getUserById(id) {
try {
// Preparar la sentencia preparada
const [rows] = await promisePool.execute(
'SELECT * FROM users WHERE id = ?',
[id]
);
return rows[0];
} catch (err) {
console.error('Error de consulta:', err);
throw err;
}
}
try {
// Preparar la sentencia preparada
const [rows] = await promisePool.execute(
'SELECT * FROM users WHERE id = ?',
[id]
);
return rows[0];
} catch (err) {
console.error('Error de consulta:', err);
throw err;
}
}
Escucha de eventos del pool de conexiones
Ejemplo
pool.on('connection', (connection) => {
console.log('Nueva conexión establecida');
});
pool.on('acquire', (connection) => {
console.log('Conexión obtenida');
});
pool.on('release', (connection) => {
console.log('Conexión liberada');
});
pool.on('enqueue', () => {
console.log('Esperando conexión disponible');
});
console.log('Nueva conexión establecida');
});
pool.on('acquire', (connection) => {
console.log('Conexión obtenida');
});
pool.on('release', (connection) => {
console.log('Conexión liberada');
});
pool.on('enqueue', () => {
console.log('Esperando conexión disponible');
});
Manejo de errores y depuración
Tipos de errores comunes
- Error de conexión: servidor de base de datos inalcanzable, fallo de autenticación, etc.
- Error de sintaxis en la consulta: la sentencia SQL es incorrecta
- Violación de restricciones: como clave primaria duplicada, restricciones de clave externa, etc.
- Error de tiempo de espera: la consulta tarda demasiado en ejecutarse
Estrategias de manejo de errores
Ejemplo
async function safeQuery(sql, params) {
try {
const [rows] = await promisePool.query(sql, params);
return rows;
} catch (err) {
// Tomar diferentes medidas según el tipo de error
switch (err.code) {
case 'ER_DUP_ENTRY':
console.warn('Entrada duplicada:', err.sqlMessage);
throw new Error('Los datos ya existen');
case 'ECONNREFUSED':
console.error('No se pudo conectar a la base de datos');
throw new Error('Servicio no disponible, inténtelo de nuevo más tarde');
default:
console.error('Error de base de datos:', err);
throw err;
}
}
}
try {
const [rows] = await promisePool.query(sql, params);
return rows;
} catch (err) {
// Tomar diferentes medidas según el tipo de error
switch (err.code) {
case 'ER_DUP_ENTRY':
console.warn('Entrada duplicada:', err.sqlMessage);
throw new Error('Los datos ya existen');
case 'ECONNREFUSED':
console.error('No se pudo conectar a la base de datos');
throw new Error('Servicio no disponible, inténtelo de nuevo más tarde');
default:
console.error('Error de base de datos:', err);
throw err;
}
}
}
Sugerencias para optimización del rendimiento
- Configurar adecuadamente el tamaño del pool de conexiones: normalmente de 2 a 3 veces el número de núcleos de CPU
- Usar un pool de conexiones en lugar de una conexión única: especialmente en aplicaciones web
- Usar índices adecuadamente: acelerar el rendimiento de las consultas
- Operaciones por lotes: reducir el número de idas y vueltas (round-trips)
- Usar sentencias preparadas: mejorar el rendimiento de consultas repetidas
- Liberar recursos periódicamente: evitar fugas de conexiones
Ejemplo de inserción por lotes:
Ejemplo
async function batchInsertUsers(users) {
const values = users.map(user => [user.name, user.email]);
try {
const [result] = await promisePool.query(
'INSERT INTO users (name, email) VALUES ?',
[values]
);
console.log('Filas insertadas:', result.affectedRows);
return result;
} catch (err) {
console.error('Error en la inserción masiva:', err);
throw err;
}
}
const values = users.map(user => [user.name, user.email]);
try {
const [result] = await promisePool.query(
'INSERT INTO users (name, email) VALUES ?',
[values]
);
console.log('Filas insertadas:', result.affectedRows);
return result;
} catch (err) {
console.error('Error en la inserción masiva:', err);
throw err;
}
}
Consideraciones de seguridad
- Nunca concatenes cadenas SQL: usa consultas parametrizadas para prevenir la inyección SQL
- Limita los permisos del usuario de la base de datos: la cuenta de la aplicación solo necesita los permisos necesarios
- Cifra datos sensibles: por ejemplo, las contraseñas deben almacenarse con hash y sal
- Usa conexiones SSL: en producción se recomienda cifrar la conexión
- Actualiza las dependencias periódicamente: mantén el paquete mysql2 en su versión más reciente
Estructura completa del proyecto de ejemplo
project/ ├── config/ │ └── db.js # 数据库配置 ├── models/ │ └── userModel.js # 数据模型 ├── services/ │ └── userService.js # 业务逻辑 ├── app.js # 主应用文件 └── package.json
Ejemplo de db.js:
Ejemplo
const mysql = require('mysql2');
const pool = mysql.createPool({
host: process.env.DB_HOST || 'localhost',
user: process.env.DB_USER || 'root',
password: process.env.DB_PASSWORD || '',
database: process.env.DB_NAME || 'test_db',
waitForConnections: true,
connectionLimit: 10,
queueLimit: 0
});
module.exports = pool.promise();
const pool = mysql.createPool({
host: process.env.DB_HOST || 'localhost',
user: process.env.DB_USER || 'root',
password: process.env.DB_PASSWORD || '',
database: process.env.DB_NAME || 'test_db',
waitForConnections: true,
connectionLimit: 10,
queueLimit: 0
});
module.exports = pool.promise();