MySQL Node.js Verbindung und Verwendung
MySQL ist eine der beliebtesten Open-Source-relationalen Datenbanken, und Node.js ist eine JavaScript-Laufzeitumgebung basierend auf der Chrome V8-Engine. Die Kombination der beiden ermöglicht es Ihnen, leistungsstarke Backend-Dienste zu erstellen.
Warum MySQL + Node.js wählen?
- MySQL bietet zuverlässige Datenspeicherung und -verwaltung
- Das nicht-blockierende I/O-Modell von Node.js eignet sich für Datenbankoperationen
- JavaScript-Full-Stack-Entwicklung (Verwendung derselben Sprache für Frontend und Backend)
- Das reichhaltige npm-Ökosystem bietet viele MySQL-bezogene Pakete
Installation der erforderlichen Abhängigkeiten
Bevor wir beginnen, müssen wir dasmysql2Paket installieren, das eine beliebte Wahl für die Verbindung mit MySQL in Node.js ist.
npm install mysql2
Warum mysql2 anstelle von mysql wählen?
- Bessere Leistung
- Unterstützt Promise-API
- Unterstützt Prepared Statements
- Aktive Wartung
Datenbankverbindung herstellen
Grundlegende Verbindungskonfiguration
Beispiel
const mysql = require('mysql2');
// Verbindungspool erstellen (für die Produktion empfohlen)
const pool = mysql.createPool({
host: 'localhost', // Adresse des Datenbankservers
user: 'root', // Datenbank-Benutzername
password: 'password', // Datenbank-Passwort
database: 'test_db', // Name der Datenbank, zu der verbunden werden soll
waitForConnections: true,
connectionLimit: 10, // Maximale Anzahl von Verbindungen im Pool
queueLimit: 0
});
// Eine Promise-basierte Verbindung abrufen
const promisePool = pool.promise();
// Verbindungspool erstellen (für die Produktion empfohlen)
const pool = mysql.createPool({
host: 'localhost', // Adresse des Datenbankservers
user: 'root', // Datenbank-Benutzername
password: 'password', // Datenbank-Passwort
database: 'test_db', // Name der Datenbank, zu der verbunden werden soll
waitForConnections: true,
connectionLimit: 10, // Maximale Anzahl von Verbindungen im Pool
queueLimit: 0
});
// Eine Promise-basierte Verbindung abrufen
const promisePool = pool.promise();
Verbindungspool vs. Einzelverbindung
Vorteile eines Verbindungspools:
- Verbindungen wiederverwenden, Overhead reduzieren
- Verbindungslebenszyklus automatisch verwalten
- Verbindungslecks verhindern
- Bessere Leistung
Szenarien, die für eine Einzelverbindung geeignet sind:
- Einfache Skripte
- Testumgebung
- Anwendungen mit geringer Nebenläufigkeit
Grundlegende CRUD-Operationen ausführen
Daten abfragen (SELECT)
Beispiel
async function getUsers() {
try {
const [rows, fields] = await promisePool.query('SELECT * FROM users');
console.log(rows);
return rows;
} catch (err) {
console.error('Abfragefehler:', err);
throw err;
}
}
try {
const [rows, fields] = await promisePool.query('SELECT * FROM users');
console.log(rows);
return rows;
} catch (err) {
console.error('Abfragefehler:', err);
throw err;
}
}
Daten einfügen (INSERT)
Beispiel
async function addUser(user) {
try {
const [result] = await promisePool.query(
'INSERT INTO users (name, email) VALUES (?, ?)',
[user.name, user.email]
);
console.log('Einfüge-ID:', result.insertId);
return result;
} catch (err) {
console.error('Einfügefehler:', err);
throw err;
}
}
try {
const [result] = await promisePool.query(
'INSERT INTO users (name, email) VALUES (?, ?)',
[user.name, user.email]
);
console.log('Einfüge-ID:', result.insertId);
return result;
} catch (err) {
console.error('Einfügefehler:', err);
throw err;
}
}
Daten aktualisieren (UPDATE)
Beispiel
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('Betroffene Zeilen:', result.affectedRows);
return result;
} catch (err) {
console.error('Aktualisierungsfehler:', err);
throw err;
}
}
try {
const [result] = await promisePool.query(
'UPDATE users SET name = ?, email = ? WHERE id = ?',
[updates.name, updates.email, id]
);
console.log('Betroffene Zeilen:', result.affectedRows);
return result;
} catch (err) {
console.error('Aktualisierungsfehler:', err);
throw err;
}
}
Daten löschen (DELETE)
Beispiel
async function deleteUser(id) {
try {
const [result] = await promisePool.query(
'DELETE FROM users WHERE id = ?',
[id]
);
console.log('Gelöschte Zeilen:', result.affectedRows);
return result;
} catch (err) {
console.error('Löschfehler:', err);
throw err;
}
}
try {
const [result] = await promisePool.query(
'DELETE FROM users WHERE id = ?',
[id]
);
console.log('Gelöschte Zeilen:', result.affectedRows);
return result;
} catch (err) {
console.error('Löschfehler:', err);
throw err;
}
}
Erweiterte Funktionen und Best Practices
Transaktionsverwaltung
Beispiel
async function transferFunds(fromId, toId, amount) {
let connection;
try {
// Eine Verbindung aus dem Pool holen
connection = await promisePool.getConnection();
// Eine Transaktion starten
await connection.beginTransaction();
// Die Überweisung durchführen
await connection.query(
'UPDATE accounts SET balance = balance - ? WHERE id = ?',
[amount, fromId]
);
await connection.query(
'UPDATE accounts SET balance = balance + ? WHERE id = ?',
[amount, toId]
);
// Transaktion festschreiben
await connection.commit();
console.log('Transfer erfolgreich');
} catch (err) {
// Bei Fehler zurückrollen
if (connection) await connection.rollback();
console.error('Transfer fehlgeschlagen:', err);
throw err;
} finally {
// Verbindung zurück in den Pool geben
if (connection) connection.release();
}
}
let connection;
try {
// Eine Verbindung aus dem Pool holen
connection = await promisePool.getConnection();
// Eine Transaktion starten
await connection.beginTransaction();
// Die Überweisung durchführen
await connection.query(
'UPDATE accounts SET balance = balance - ? WHERE id = ?',
[amount, fromId]
);
await connection.query(
'UPDATE accounts SET balance = balance + ? WHERE id = ?',
[amount, toId]
);
// Transaktion festschreiben
await connection.commit();
console.log('Transfer erfolgreich');
} catch (err) {
// Bei Fehler zurückrollen
if (connection) await connection.rollback();
console.error('Transfer fehlgeschlagen:', err);
throw err;
} finally {
// Verbindung zurück in den Pool geben
if (connection) connection.release();
}
}
Vorbereitete Anweisungen
Vorbereitete Anweisungen können die Leistung verbessern und SQL-Injection verhindern:
Beispiel
async function getUserById(id) {
try {
// Eine vorbereitete Anweisung vorbereiten
const [rows] = await promisePool.execute(
'SELECT * FROM users WHERE id = ?',
[id]
);
return rows[0];
} catch (err) {
console.error('Abfragefehler:', err);
throw err;
}
}
try {
// Eine vorbereitete Anweisung vorbereiten
const [rows] = await promisePool.execute(
'SELECT * FROM users WHERE id = ?',
[id]
);
return rows[0];
} catch (err) {
console.error('Abfragefehler:', err);
throw err;
}
}
Überwachung von Verbindungspool-Ereignissen
Beispiel
pool.on('connection', (connection) => {
console.log('Neue Verbindung hergestellt');
});
pool.on('acquire', (connection) => {
console.log('Verbindung akquiriert');
});
pool.on('release', (connection) => {
console.log('Verbindung freigegeben');
});
pool.on('enqueue', () => {
console.log('Warten auf verfügbare Verbindung');
});
console.log('Neue Verbindung hergestellt');
});
pool.on('acquire', (connection) => {
console.log('Verbindung akquiriert');
});
pool.on('release', (connection) => {
console.log('Verbindung freigegeben');
});
pool.on('enqueue', () => {
console.log('Warten auf verfügbare Verbindung');
});
Fehlerbehandlung und Debugging
Häufige Fehlertypen
- Verbindungsfehler: Datenbankserver nicht erreichbar, Authentifizierungsfehler, usw.
- Abfrage-Syntaxfehler: fehlerhafte SQL-Anweisungen
- Constraint-Verletzungen: wie doppelte Primärschlüssel, Fremdschlüssel-Constraints usw.
- Timeout-Fehler: Abfrageausführungszeit ist zu lang
Strategien zur Fehlerbehandlung
Beispiel
async function safeQuery(sql, params) {
try {
const [rows] = await promisePool.query(sql, params);
return rows;
} catch (err) {
// Je nach Fehlertyp unterschiedliche Maßnahmen ergreifen
switch (err.code) {
case 'ER_DUP_ENTRY':
console.warn('Duplicate entry:', err.sqlMessage);
throw new Error('Data already exists');
case 'ECONNREFUSED':
console.error('Verbindung zur Datenbank nicht möglich');
throw new Error('Dienst nicht verfügbar, bitte später erneut versuchen');
default:
console.error('Datenbankfehler:', err);
throw err;
}
}
}
try {
const [rows] = await promisePool.query(sql, params);
return rows;
} catch (err) {
// Je nach Fehlertyp unterschiedliche Maßnahmen ergreifen
switch (err.code) {
case 'ER_DUP_ENTRY':
console.warn('Duplicate entry:', err.sqlMessage);
throw new Error('Data already exists');
case 'ECONNREFUSED':
console.error('Verbindung zur Datenbank nicht möglich');
throw new Error('Dienst nicht verfügbar, bitte später erneut versuchen');
default:
console.error('Datenbankfehler:', err);
throw err;
}
}
}
Tipps zur Leistungsoptimierung
- Stellen Sie die Größe des Verbindungspools passend ein: normalerweise 2-3 Mal die Anzahl der CPU-Kerne
- Verwenden Sie einen Verbindungspool anstelle einer einzelnen Verbindung: besonders in Webanwendungen
- Verwenden Sie Indizes angemessen: Beschleunigen Sie die Abfrageleistung
- Batch-Vorgänge: Roundtrips reduzieren
- Verwenden Sie Prepared Statements: Verbessern Sie die Leistung wiederholter Abfragen
- Geben Sie Ressourcen regelmäßig frei: Vermeiden Sie Verbindungslecks
Beispiel für Batch-Einfügen:
Beispiel
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('Eingefügte Zeilen:', result.affectedRows);
return result;
} catch (err) {
console.error('Batch-Einfügefehler:', 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('Eingefügte Zeilen:', result.affectedRows);
return result;
} catch (err) {
console.error('Batch-Einfügefehler:', err);
throw err;
}
}
Sicherheitsaspekte
- SQL-Strings niemals verketten: Verwenden Sie parametrisierte Abfragen, um SQL-Injection zu verhindern
- Berechtigungen von Datenbankbenutzern einschränken: Anwendungskonten benötigen nur die notwendigen Berechtigungen
- Sensible Daten verschlüsseln: Beispielsweise sollten Passwörter mit gesalzenen Hashes gespeichert werden
- SSL-Verbindungen verwenden: Verschlüsselte Verbindungen werden in der Produktion empfohlen
- Abhängigkeiten regelmäßig aktualisieren: Halten Sie das mysql2-Paket aktuell
Vollständige Beispielprojektstruktur
project/ ├── config/ │ └── db.js # 数据库配置 ├── models/ │ └── userModel.js # 数据模型 ├── services/ │ └── userService.js # 业务逻辑 ├── app.js # 主应用文件 └── package.json
db.js-Beispiel:
Beispiel
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();