在 Node.js 中连接 MySQL 数据库是一个常见的需求，特别是在构建后端服务时。以下是一个详细的教程，帮助你通过 Node.js 与 MySQL 进行连接并执行 SQL 查询操作。我们将使用 mysql 包和 express 框架来快速创建一个简单的 API 接口。

1. 安装依赖

首先，我们需要安装 MySQL 的 Node.js 客户端包 mysql 和 Web 框架 express。打开终端，进入项目目录并运行以下命令：

npm install mysql express

解释：

• mysql：MySQL 数据库的客户端包，用于与 MySQL 数据库进行交互。
• express：流行的 Web 框架，用于快速创建 API 接口和服务器。

2. 创建 Node.js 应用

在项目根目录下创建一个名为 app.js 的文件，用于编写我们的 Node.js 应用。

touch app.js

3. 导入模块

在 app.js 文件中导入 express 和 mysql 模块。

const express = require('express');
const mysql = require('mysql');
const app = express();

解释：

• express：用于创建 HTTP 服务器和 API 接口。
• mysql：用于建立与 MySQL 数据库的连接。

4. 创建 MySQL 连接池

在数据库访问时，使用连接池来管理 MySQL 连接非常重要，这可以提高性能并避免连接过多的问题。在 app.js 中添加以下代码来创建连接池：

const pool = mysql.createPool({
  host: 'localhost',
  user: 'your_mysql_username',
  password: 'your_mysql_password',
  database: 'your_database_name',
  connectionLimit: 10 // 设置连接池最大连接数
});

解释：

• host：MySQL 数据库所在主机的地址，通常为 localhost。
• user：连接 MySQL 使用的用户名。
• password：该用户名的密码。
• database：要连接的数据库名称。
• connectionLimit：连接池中允许的最大连接数，避免过多连接导致性能下降。

5. 创建接口

接下来，创建一个简单的接口，用来查询 MySQL 数据库中的 users 表中的所有数据。例如，我们假设 users 表具有 id 和 name 字段，我们将编写一个接口，返回所有用户信息：

app.get('/users', (req, res) => {
  pool.query('SELECT * FROM users', (err, rows) => {
    if (err) {
      console.error('Error querying database:', err);
      res.status(500).send('Internal Server Error');
    } else {
      res.json(rows);  // 返回查询到的用户数据
    }
  });
});

解释：

• app.get('/users', ...)：设置一个 GET 请求的路由，监听访问 /users 的请求。
• pool.query(...)：使用创建的连接池来执行 SQL 查询，这里是查询 users 表中的所有数据。
• res.json(rows)：将查询结果以 JSON 格式返回给客户端。
• res.status(500).send(...)：如果查询出错，返回 HTTP 状态码 500 和错误信息。

6. 启动服务器

现在，我们设置服务器监听一个端口（例如 3000），以便用户可以访问我们的 API。把以下代码添加到 app.js 文件底部：

const port = 3000;
app.listen(port, () => {
  console.log(`Server running on port ${port}`);
});

解释：

• app.listen(port, ...)：启动 Express 服务器并监听指定的端口。
• console.log(...)：当服务器成功启动时，打印一条信息到控制台。

7. 运行应用

在终端中，进入项目目录，并运行以下命令启动应用：

node app.js

解释：

• node app.js：执行 Node.js 应用，启动 Web 服务器并开始监听请求。

8. 测试接口

打开浏览器或使用 Postman 等工具访问
http://localhost:3000/users。如果数据库中有用户数据，您将看到类似以下的 JSON 响应：

[
  {
    "id": 1,
    "name": "John Doe"
  },
  {
    "id": 2,
    "name": "Jane Smith"
  }
]

解释：

• 如果查询成功，返回一个包含所有用户信息的 JSON 数组。
• 如果查询失败，则返回状态码 500 和错误信息。

总结

通过以上步骤，您已经成功地配置了一个使用 Node.js 和 MySQL 的简单 API 接口。总结步骤如下：

1. 安装依赖：通过 npm install 安装 mysql 和 express。
2. 创建应用：创建 app.js 文件并配置数据库连接。
3. 创建连接池：使用 mysql.createPool 来创建数据库连接池，优化数据库访问性能。
4. 创建接口：使用 Express 创建 API 路由，执行 SQL 查询并返回结果。
5. 启动服务器：通过 app.listen 启动服务器，并监听端口。
6. 测试接口：通过访问 http://localhost:3000/users 来测试接口是否正常工作。

这种方法适用于小型到中型的应用，对于大规模应用，可能需要对数据库连接池、查询优化等方面进行进一步的优化。