云计算百科
云计算领域专业知识百科平台

【Node.js 项目实战】第 10 章 MySQL:把数据放进真正的数据库

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */
#content_views .toc,
/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */
#content_views.markdown_views > p:empty:has(+ .toc),
#content_views.markdown_views > .toc + p:empty,
/* 富文本旧版目录标记 */
#content_views.htmledit_views #main-toc,
#content_views.htmledit_views #hr-toc,
#content_views.htmledit_views p[id*=\”-toc\”] {
display: none !important;
}
/* 目录去掉后,紧跟的首个标题不再多出一块上边距 */
#content_views.markdown_views > .toc + h1,
#content_views.markdown_views > .toc + h2,
#content_views.markdown_views > .toc + h3,
#content_views.markdown_views > .toc + h4,
#content_views.markdown_views > .toc + p:empty + h1,
#content_views.markdown_views > .toc + p:empty + h2,
#content_views.markdown_views > .toc + p:empty + h3,
#content_views.markdown_views > .toc + p:empty + h4 {
margin-top: 0 !important;
}

第 10 章 MySQL:把数据放进真正的数据库

本章版本:v1.0 本章产出:sql/schema.sql、src/db.js、src/repositories/mysqlTodoRepository.js、scripts/init-db.js

本章目标:安装并启动 MySQL,建库建表,用 mysql2 连接池实现 CRUD,理解占位符、字段映射和存储切换。

在这里插入图片描述 图 10-1 · 换的是仓库实现,不是业务接口

10.1 JSON 文件的退休申请

第九周第一节课,李老师在讲台上放了一个纸盒子,上面写着“data/todos.json 退休欢送会”。

“先给它记一功。”他说,“从第 6 章到今天,它扛住了你们所有的数据,让每个人体验了持久化。但它有两个治不了的病:”

第一,每次读写都要操作整个文件。 哪怕只查一条待办,也要把整个 JSON 读进来、JSON.parse 成数组、再 find。数据量到几万条,内存和 CPU 都吃不消。

第二,不支持复杂查询。“想查‘所有未完成的待办,按创建时间倒序,只取前 20 条’,怎么办?”

“先读全量,再 filter,再 sort,再 slice。”林雪霸背得出来。

“对,全量。数据库就是为这两个问题生的。今天选 MySQL——全球最流行的关系型数据库之一,学校环境、企业项目里都非常常见。”

对比表

JSON 文件
MySQL
数据单位:整个文件 表(table)
数据行:数组元素 行(row)
字段:对象属性 列(column)
主键:手动生成 AUTO_INCREMENT 自增
查询:读全量再过滤 SQL 条件查询、索引
并发:容易冲突 事务、锁、连接池

一条待办在 MySQL 里长这样:

id
title
completed
created_at
1 学习 MySQL 0 2026-10-09 08:00:00
2 完成项目 1 2026-10-09 09:00:00

“completed 用 0/1 表示布尔值,created_at 记录创建时间。”李老师说,“注意,这不是‘JSON 的敌人’,是 JSON 的进化形态——数据还是那些数据,只是住进了有物业的房子。”

10.2 安装与启动 MySQL

“安装方式三选一。”

方式一:本地安装 MySQL Community Server(推荐)。

  • 访问 https://dev.mysql.com/downloads/mysql/,选择操作系统,下载 Community Server。
  • Windows 安装时选 “Developer Default” 或 “Server only”,设置 root 密码,记住它。
  • macOS 用 Homebrew:

brew install mysql
brew services start mysql

  • Linux(Ubuntu/Debian):

sudo apt update
sudo apt install mysql-server
sudo systemctl start mysql

方式二:XAMPP / WAMP(适合 Windows)。 装好打开 Control Panel 启动 MySQL,默认 root 密码为空,端口 3306。

验证:

mysql -u root -p

看到 mysql> 提示符就成功了,exit 退出。

“如果提示 mysql 不是内部或外部命令,”李老师看向陈金宝。

“PATH。”陈金宝条件反射。

“对。把 MySQL 的 bin 目录加进 PATH,或者用 MySQL Workbench 图形化工具,或者用完整路径执行。”

检查服务(Windows):

Get-Service | Where-Object {

$_.Name -like \’*mysql*\’ }
Start-Service MySQL80

“服务名可能是 MySQL80、MySQL 或 mysql,以实际为准。”

10.3 建库建表:一行一行讲

登录 MySQL 后执行:

CREATE DATABASE IF NOT EXISTS todo_app
DEFAULT CHARACTER SET utf8mb4
COLLATE utf8mb4_unicode_ci;

USE todo_app;

CREATE TABLE IF NOT EXISTS todos (
id INT UNSIGNED NOT NULL AUTO_INCREMENT,
title VARCHAR(255) NOT NULL,
completed TINYINT(1) NOT NULL DEFAULT 0,
created_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
updated_at DATETIME(3) NOT NULL DEFAULT CURRENT_TIMESTAMP(3)
ON UPDATE CURRENT_TIMESTAMP(3),
PRIMARY KEY (id),
KEY idx_todos_completed_created (completed, created_at)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci;

INSERT INTO todos (title, completed) VALUES
(\’学习 Node.js\’, 0),
(\’完成项目立项\’, 1),
(\’复习 MySQL\’, 0);

SELECT * FROM todos;

“逐行提问时间。”

  • id INT UNSIGNED AUTO_INCREMENT PRIMARY KEY:无符号整数,自增主键。UNSIGNED 表示不允许负数,范围更大。
  • title VARCHAR(255) NOT NULL:第 1 章说的“数据库层保险”,现在兑现了。
  • completed TINYINT(1) NOT NULL DEFAULT 0:MySQL 的 BOOLEAN 是 TINYINT(1) 的别名。
  • created_at DATETIME(3) DEFAULT CURRENT_TIMESTAMP(3):创建时自动填当前时间,3 位毫秒。
  • updated_at … ON UPDATE CURRENT_TIMESTAMP(3):每次更新行自动刷新。“**就算你的业务代码忘了写 updated_at,数据库也会替你维护。**多一道保险,少一次事故。”
  • KEY idx_todos_completed_created (completed, created_at):联合索引,加速“按状态筛选 + 按时间排序”——正好是你们列表页的查询形状。
  • ENGINE=InnoDB:支持事务、行锁、外键。
  • CHARSET=utf8mb4:支持中文和 emoji。

“为什么不是 utf8?”关羽问。

“MySQL 的 utf8 最多 3 字节,emoji 是 4 字节,会直接报错。”李老师说,“别用 utf8,用 utf8mb4——名字少一个字母,能力差一截,这是 MySQL 历史遗留的最大冷笑话。”

为什么时间用 UTC

“created_at 存 UTC,不存本地时间。服务器迁移到不同时区,数据不错乱;展示时再转本地时区。”

“在 Node.js 里,我们通过 mysql2 的 timezone: \’Z\’ 告诉驱动‘数据库里的时间按 UTC 解释’,读出来就是正确的 Date,再 toISOString() 返回前端。”

用脚本初始化

“手动执行 SQL 容易漏、容易忘。项目里提供 npm run db:init。”

scripts/init-db.js:

const mysql = require(\’mysql2/promise\’);
const config = require(\’../src/config\’);

async function main() {


const {

database } = config.db;
if (!/^[A-Za-z0-9_]+$

赞(0)
未经允许不得转载:网硕互联帮助中心 » 【Node.js 项目实战】第 10 章 MySQL:把数据放进真正的数据库
分享到: 更多 (0)

评论 抢沙发

评论前必须登录!