Ubuntu系统下Node.js连接数据库的详细步骤

时间：2026-05-09 08:31

在Ubuntu系统中连接Node js与数据库需遵循系列步骤。首先安装Node js运行环境，推荐选择LTS版本。接着安装并启动数据库服务，以MongoDB为例。然后在Node js项目中安装对应驱动，例如mongoose库。最后编写连接代码并运行验证，确保成功建立连接。其他数据库如MySQL或PostgreSQL操作逻辑类似。

在Ubuntu系统上，让Node.js应用与数据库“握手”成功，其实是一系列清晰步骤的组合。下面这张图可以帮你快速建立整体印象，咱们接着往下看具体的操作路径。

Ubuntu Node.js数据库如何连接

第一步：安装Node.js运行环境

如果系统里还没有Node.js，事情就无从谈起。你需要先去Node.js的官方网站（https://nodejs.org/）下载适用于Ubuntu的安装包。选择LTS（长期支持）版本通常是个稳妥的选择，它能保证更好的稳定性和兼容性。

第二步：选择并安装数据库

数据库的选择取决于你的项目需求。这里以MongoDB为例，因为它与Node.js的生态结合紧密，在开发社区中非常流行。安装过程通过终端命令就能轻松完成：

sudo apt update
sudo apt install -y mongodb

第一条命令是更新软件包列表，确保获取到最新的安装源信息；第二条则是执行MongoDB的安装。

第三步：启动数据库服务

安装完成后，数据库服务并不会自动运行。需要手动启动它，命令很简单：

sudo systemctl start mongod

执行后，MongoDB服务就在后台运行起来了，准备接受连接。

第四步：在Node.js项目中安装数据库驱动

Node.js应用需要通过特定的驱动库来与数据库通信。对于MongoDB，mongoose是一个广受欢迎的优秀ODM（对象文档映射）库。在你的项目根目录下，运行npm命令安装它：

npm install mongoose

第五步：编写连接代码

驱动就位后，就可以在代码中建立连接了。通常在项目中会创建一个专门处理数据库连接的文件，例如db.js，并写入以下代码：

const mongoose = require('mongoose');

mongoose.connect('mongodb://localhost:27017/myDatabase', {
    useNewUrlParser: true,
    useUnifiedTopology: true,
})
.then(() => console.log('Connected to MongoDB'))
.catch((error) => console.error('Could not connect to MongoDB', error));

注意，你需要把连接字符串中的myDatabase替换成你自己想要使用的数据库名称。

第六步：运行与验证

完成以上步骤后，运行你的Node.js应用程序。如果控制台输出“Connected to MongoDB”的日志，那么恭喜你，连接已经成功建立。

当然，这只是一个最基础的连接示例。实际项目中，你还需要考虑连接池配置、错误重试机制、生产环境的安全设置（如使用环境变量管理连接字符串）等诸多因素。如果你选用的是其他数据库，比如MySQL或PostgreSQL，思路也是类似的：安装对应的Node.js驱动（如mysql2或pg），然后根据其文档编写连接配置即可。核心逻辑就是：准备好环境，安装好桥梁（驱动），然后用正确的地址和参数建立连接。

来源：https://www.yisu.com/ask/39275155.html

Ubuntu