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 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;
  }
}

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;
  }
}

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;
  }
}

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;
  }
}

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();
  }
}

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;
  }
}

Ü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');
});

Fehlerbehandlung und Debugging

Häufige Fehlertypen

  1. Verbindungsfehler: Datenbankserver nicht erreichbar, Authentifizierungsfehler, usw.
  2. Abfrage-Syntaxfehler: fehlerhafte SQL-Anweisungen
  3. Constraint-Verletzungen: wie doppelte Primärschlüssel, Fremdschlüssel-Constraints usw.
  4. 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;
    }
  }
}

Tipps zur Leistungsoptimierung

  1. Stellen Sie die Größe des Verbindungspools passend ein: normalerweise 2-3 Mal die Anzahl der CPU-Kerne
  2. Verwenden Sie einen Verbindungspool anstelle einer einzelnen Verbindung: besonders in Webanwendungen
  3. Verwenden Sie Indizes angemessen: Beschleunigen Sie die Abfrageleistung
  4. Batch-Vorgänge: Roundtrips reduzieren
  5. Verwenden Sie Prepared Statements: Verbessern Sie die Leistung wiederholter Abfragen
  6. 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;
  }
}

Sicherheitsaspekte

  1. SQL-Strings niemals verketten: Verwenden Sie parametrisierte Abfragen, um SQL-Injection zu verhindern
  2. Berechtigungen von Datenbankbenutzern einschränken: Anwendungskonten benötigen nur die notwendigen Berechtigungen
  3. Sensible Daten verschlüsseln: Beispielsweise sollten Passwörter mit gesalzenen Hashes gespeichert werden
  4. SSL-Verbindungen verwenden: Verschlüsselte Verbindungen werden in der Produktion empfohlen
  5. 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();
Andere Erweiterungen