MySQL node.js mysql error: ECONNREFUSED

MySQL是一种流行的关系数据库管理系统，常常用来储存和处理数据。Node.js是一种强大的JavaScript运行环境。在使用Node.js连接MySQL时，有时可能会遇到如下错误信息：Error: connect ECONNREFUSED。本文将深入解析这个错误，并提供一些解决方法和预防措施。

阅读更多：MySQL 教程

什么是ECONNREFUSED错误

ECONNREFUSED 是一种 Node.js 错误代码，当你试图在 Node.js 中与某个服务建立一个 TCP 连接，但是服务没有在指定的端口号上进行监听或者拒绝了连接请求，就会出现这个错误。

在 Node.js + MySQL 开发中，通常会使用 JavaScript 的 mysql 包来连接 MySQL 数据库。当使用 mysql 包连接 MySQL 服务时，ECONNREFUSED 错误可能是以下几个原因导致的:

MySQL 服务未启动。在执行 MySQL 的应用程序之前运行 MySQL 服务。
MySQL 服务未监听指定的端口。如果服务配置了另一个端口，请确保在连接时指定了正确的端口号。
防火墙或代理服务器拒绝了连接。请确保防火墙或代理服务器不会阻止 MySQL 服务。

解决ECONNREFUSED错误

下面列出了一些解决此错误的方法。

1. 确保MySQL服务正在运行

在使用Node.js连接MySQL之前，请确保MySQL服务正在运行。如果您是在本地环境中运行MySQL服务器，则可以使用以下命令检查MySQL服务是否正在运行：

$ sudo service mysql status

如果MySQL服务正在运行，您应该会看到以下信息：

mysql.service - MySQL Community Server
   Loaded: loaded (/lib/systemd/system/mysql.service; enabled; vendor preset: enabled)
   Active: active (running) since Wed ...; 1h 17min ago

2. 确保MySQL服务在正确端口监听

如果MySQL服务器配置了自定义端口，则无法使用 MySQL 默认端口（3306）连接到服务。在这种情况下，您需要在 MySQL 连接选项中指定端口号。

使用 mysql 包连接 MySQL 服务时，需要指定连接参数。请尝试根据以下示例设置您的连接：

var mysql = require('mysql');
var connection = mysql.createConnection({
  host: 'localhost',
  port: 3306,
  user: 'your_mysql_user',
  password: 'your_mysql_password',
  database: 'your_mysql_database'
});

connection.connect(function(err) {
  if (err) throw err;
  console.log("Connected!");
});

3. 禁用防火墙或代理服务器

有时候，ECONNREFUSED 错误可能是因为防火墙或代理服务器拒绝了连接。如果您使用的是 Linux，您可以使用以下命令禁用防火墙：

$ sudo ufw disable

如果您遇到类似于 ECONNREFUSED 错误的问题，可以尝试关闭防火墙来确定问题是否与防火墙有关。

4. 确保MySQL监听所有IP地址

如果MySQL服务器仅监听localhost本地IP地址，您将无法从外部连接到该服务。要确保MySQL服务器监听了所有IP地址，请在 MySQL 配置文件中，设置 MySQL 监听所有IP地址。在 Ubuntu 上，MySQL 配置文件是 /etc/mysql/mysql.conf.d/mysqld.cnf

$ sudo vim /etc/mysql/mysql.conf.d/mysqld.cnf

找到以下行并将其更改为：

bind-address = 0.0.0.0

然后，保存并退出文件并重启 MySQL 服务。

$ sudo service mysql restart

预防措施

为了防止ECONNREFUSED错误的发生，可以采取以下措施：

1. 检查端口号和IP地址

在连接 MySQL 时，确保正确指定了 MySQL 服务器的端口号和 IP 地址。如果 MySQL 配置文件中指定了非默认端口，应将其包含在连接选项中。此外，确保您正在使用正确的 IP 地址。在大多数情况下，这将是 localhost，但在某些情况下，您可能需要使用服务器的公共 IP 地址。

2. 监控 MySQL 服务器

在连接 MySQL 数据库期间出现错误时，监控 MySQL 服务器以查看是否发生了故障或过载。您可以通过 MySQL 提供的监控工具进行故障转移或扩展以保持高可用性。

3. 使用连接池

使用连接池会在 Node.js 应用程序中封装 MySQL 连接，以便重复使用已打开的连接而不是为每个查询打开一个新连接。这减少了连接开销并提高了应用程序的响应能力。

下面是mysqljs / mysql连接池的一个示例：

const mysql = require('mysql');
const pool = mysql.createPool({
    connectionLimit: 10,
    host: 'localhost',
    user: 'your_mysql_user',
    password: 'your_mysql_password',
    database: 'your_mysql_database'
});

pool.getConnection((err, connection) => {
    if (err) {
        console.error('Failed to create MySQL connection pool', err);
    }
    connection.query('SELECT * FROM users', (err, rows) => {
        connection.release();
        if (err) {
            console.error('Failed to execute query', err);
        }
        console.log(rows);
    });
});

总结

在使用 Node.js 连接 MySQL 时，遇到 ECONNREFUSED 错误有多种原因和解决方法。首先，请确保 MySQL 服务是否正在运行，并且服务已在正确的端口上进行监听。其次，请检查您的防火墙或代理服务器是否阻止了对 MySQL 服务的访问。最后，请考虑使用连接池来管理 MySQL 连接，并定期监视 MySQL 服务器以检测故障和问题。