MySQL2 项目中的错误处理最佳实践-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00485/article/details/148548618

MySQL2 项目中的错误处理最佳实践

node-mysql2 :zap: fast mysqljs/mysql compatible mysql driver for node.js 项目地址: https://gitcode.com/gh_mirrors/no/node-mysql2

前言

在数据库操作中，错误处理是保证应用健壮性的关键环节。MySQL2 作为 Node.js 中流行的 MySQL 客户端库，提供了多种错误处理机制。本文将详细介绍如何在 MySQL2 中有效地捕获和处理各种类型的错误。

错误处理基础

MySQL2 支持两种主要的错误处理方式：

回调函数方式（传统方式）
Promise/async-await 方式（现代方式）

无论采用哪种方式，核心原则都是及时捕获并妥善处理错误，避免错误向上传播导致应用崩溃。

回调函数方式的错误处理

1. 连接错误处理

创建独立连接

const mysql = require('mysql2');

const connection = mysql.createConnection({
  host: 'localhost',
  user: 'root',
  database: 'test'
});

// 添加错误监听器
connection.on('error', (err) => {
  if (err) {
    console.error('数据库连接错误:', err);
    // 这里可以添加重连逻辑或其他错误处理
  }
});

连接池错误处理

const pool = mysql.createPool({
  host: 'localhost',
  user: 'root',
  database: 'test',
  waitForConnections: true,
  connectionLimit: 10
});

pool.getConnection((err, connection) => {
  if (err) {
    console.error('获取连接失败:', err);
    return;
  }
  
  // 使用连接...
  connection.release();
});

连接集群错误处理

const poolCluster = mysql.createPoolCluster();

poolCluster.add('MASTER', {
  host: 'master.example.com',
  user: 'root',
  database: 'test'
});

poolCluster.getConnection('MASTER', (err, connection) => {
  if (err) {
    console.error('从集群获取连接失败:', err);
    return;
  }
  
  // 使用连接...
  connection.release();
});

2. 查询错误处理

execute 方法

connection.execute('SELECT * FROM non_existent_table', (err, results) => {
  if (err) {
    console.error('执行查询失败:', err);
    return;
  }
  
  console.log('查询结果:', results);
});

query 方法

connection.query('SELECT * FROM users WHERE id = ?', [userId], (err, results) => {
  if (err) {
    console.error('查询失败:', err);
    return;
  }
  
  console.log('用户信息:', results);
});

Promise/async-await 方式的错误处理

1. 连接错误处理

创建独立连接

import mysql from 'mysql2/promise';

async function connectToDatabase() {
  try {
    const connection = await mysql.createConnection({
      host: 'localhost',
      user: 'root',
      database: 'test'
    });
    return connection;
  } catch (err) {
    console.error('创建连接失败:', err);
    throw err; // 或者处理错误后返回null/undefined
  }
}

连接池错误处理

const pool = mysql.createPool({
  host: 'localhost',
  user: 'root',
  database: 'test'
});

async function getConnection() {
  try {
    const connection = await pool.getConnection();
    return connection;
  } catch (err) {
    console.error('从连接池获取连接失败:', err);
    throw err;
  }
}

2. 查询错误处理

execute 方法

async function getUserById(userId) {
  try {
    const [rows] = await connection.execute(
      'SELECT * FROM users WHERE id = ?',
      [userId]
    );
    return rows[0] || null;
  } catch (err) {
    console.error('查询用户失败:', err);
    throw err;
  }
}

query 方法

async function getProducts() {
  try {
    const [rows] = await connection.query('SELECT * FROM products');
    return rows;
  } catch (err) {
    console.error('获取产品列表失败:', err);
    throw err;
  }
}

错误类型详解

MySQL2 中可能遇到的错误类型包括：

连接错误：数据库服务器不可达、认证失败等
查询语法错误：SQL 语句编写错误
约束错误：违反唯一性约束、外键约束等
超时错误：查询执行时间过长
连接池错误：连接池耗尽等

最佳实践建议

始终检查错误：不要忽略任何可能的错误
适当的错误日志：记录足够的信息以便调试
错误分类处理：根据错误类型采取不同措施
资源释放：确保在错误发生时释放数据库连接
重试机制：对于临时性错误可考虑实现重试逻辑
优雅降级：在错误发生时提供备用方案

高级错误处理模式

1. 事务中的错误处理

async function transferFunds(fromId, toId, amount) {
  const conn = await pool.getConnection();
  try {
    await conn.beginTransaction();
    
    // 扣款
    await conn.execute(
      'UPDATE accounts SET balance = balance - ? WHERE id = ?',
      [amount, fromId]
    );
    
    // 存款
    await conn.execute(
      'UPDATE accounts SET balance = balance + ? WHERE id = ?',
      [amount, toId]
    );
    
    await conn.commit();
    return true;
  } catch (err) {
    await conn.rollback();
    console.error('转账失败:', err);
    return false;
  } finally {
    conn.release();
  }
}

2. 自定义错误处理中间件

可以创建一个统一的数据库错误处理中间件，集中处理各种数据库操作错误。

class DatabaseErrorHandler {
  static handleConnectionError(err) {
    // 连接错误的特定处理逻辑
  }
  
  static handleQueryError(err) {
    // 查询错误的特定处理逻辑
  }
  
  // 其他错误处理方法...
}

// 使用示例
try {
  await connection.execute('...');
} catch (err) {
  DatabaseErrorHandler.handleQueryError(err);
}