在使用Node.js开发后端服务时，MySQL是最常见的关系型数据库之一。很多开发者在初次搭建环境时，容易卡在依赖安装或配置连接上。本教程将带你从零开始，完成MySQL服务端、Node.js驱动库的安装以及基础连通测试，确保你的项目能顺利读写数据。整个过程不需要复杂的图形界面操作，纯命令行即可完成，适合所有主流操作系统。
准备工作与基础环境检查
在动手安装之前，请确认你的电脑已经正确安装了Node.js运行环境。打开终端或命令行工具，输入node -v命令查看版本号，通常建议直接使用LTS长期支持版本。同时，你需要提前下载并安装好MySQL服务端软件。Windows用户可以去官网下载安装包，一路默认点击下一步即可，安装过程中务必记住设置的root密码。macOS用户推荐使用Homebrew执行brew install mysql进行安装。Linux系统可以通过apt或yum直接拉取。安装完成后，启动数据库服务，并记住默认端口是3306，这是后续代码连接的必填项。
安装Node.js官方推荐驱动库
Node.js本身不内置数据库操作功能，必须通过第三方模块来实现。目前社区最稳定且广泛使用的是mysql2库，它完全兼容官方mysql模块，但性能更好，且原生支持Promise语法，避免了回调地狱的问题。在你的项目根目录下打开终端，执行npm install mysql2 --save命令。如果网络较慢，可以切换国内镜像源或者使用yarn add mysql2。安装完成后，你会在项目目录的node_modules文件夹中看到对应的依赖文件，这表示底层驱动已经就绪，可以直接在代码中调用。
编写数据库连接代码
依赖安装完毕，接下来就是写代码建立连接。新建一个index.js文件，首先引入模块const mysql = require('mysql2/promise')。接着定义连接配置对象，包含host地址一般填localhost，port端口填3306，user填写root，password填入你当初设置的密码，database写上你要操作的数据库名。使用createPool方法创建连接池，这样比单连更节省资源，适合高并发场景。你可以用await pool.getConnection()获取一个具体连接，然后通过query方法执行sql语句，比如查询系统时间select now()。最后记得调用connection.release()释放连接回池中，并用pool.end()优雅关闭所有连接，防止内存泄漏。
运行测试与常见问题排查
代码写好之后，在终端输入node index.js运行脚本。如果终端打印出当前时间戳，说明数据库连通成功。如果出现连接被拒绝报错，优先检查MySQL服务是否在后台正常运行。如果是密码错误提示，请核对配置文件中的字符串是否多打了空格。权限不足的情况也很常见，有些新安装的MySQL为了安全会限制非本地访问，此时需要在数据库内执行授权命令刷新权限表。另外，字符集乱码问题可以通过在连接配置里加上charset utf8mb4来解决，这能完美兼容emoji表情和多语言文本。如果遇到ES模块导入报错，请在package.json里添加type module字段，或者将后缀改为cjs。
后续开发建议
基础连通只是第一步，实际项目中强烈建议使用ORM框架如Sequelize或Prisma来管理数据模型，避免手写SQL带来的安全隐患。配合环境变量管理数据库账号密码，不要硬编码在代码里提交到版本控制系统。遇到复杂查询时善用索引优化，定期备份数据。按照这套流程搭建起来的环境非常稳定，能够支撑绝大多数中小型应用的后端需求。掌握这些基础操作后，你可以轻松扩展分页查询、事务处理等高级功能，大幅提升开发效率。
