Node.js写接口连接MySQL数据库教程
在 Node.js 中连接 MySQL 数据库是一个常见的需求，特别是在构建后端服务时。以下是一个详细的教程，帮助你通过 Node.js 与 MySQL 进行连接并执行 SQL 查询操作。我们将使用 mysql 包和 express 框架来快速创建一个简单的 API 接口。
直达服务器选购网址：www.tsyvps.com
直达服务器选购网址：www.tsyvps.com
直达服务器选购网址：www.tsyvps.com
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 接口。总结步骤如下：
- 安装依赖：通过 npm install 安装 mysql 和 express。
- 创建应用：创建 app.js 文件并配置数据库连接。
- 创建连接池：使用 mysql.createPool 来创建数据库连接池，优化数据库访问性能。
- 创建接口：使用 Express 创建 API 路由，执行 SQL 查询并返回结果。
- 启动服务器：通过 app.listen 启动服务器，并监听端口。
- 测试接口：通过访问 http://localhost:3000/users 来测试接口是否正常工作。
这种方法适用于小型到中型的应用，对于大规模应用，可能需要对数据库连接池、查询优化等方面进行进一步的优化。