首页 > 编程语言 >Linux下Node.js数据库连接配置指南

Linux下Node.js数据库连接配置指南

来源：互联网 2026-07-23 08:14:13

在Linux环境下配置Node.js连接数据库需依次完成：选择主流数据库（如MySQL、PostgreSQL），安装并启动数据库服务，创建用户和数据库，安装对应客户端库（如mysql2或pg），在代码中通过环境变量配置连接参数，最后验证连接成功。

在 Linux 环境下，让 Node.js 应用顺利连上数据库，其实就几步常规操作，并不复杂。下面把整个流程拆开来看，每一步都讲清楚，你照着做就行。

长期稳定更新的攒劲资源： >>>点此立即查看<<<

选数据库——这是决策的第一步。市面上主流的选择就那么几样：MySQL、PostgreSQL、MongoDB、SQLite，当然还有别的，但绝大部分场景下从这四种里挑一个就够了。根据你的业务需求、数据结构、团队熟悉程度来定，没有绝对的好坏。
安装数据库服务——选好之后，在 Linux 上把它装上去。以 MySQL 为例，用包管理器搞定：
```
sudo apt update
sudo apt install mysql-server
```
如果是 PostgreSQL，命令也很类似：
```
sudo apt update
sudo apt install postgresql postgresql-contrib
```
装完就算完成了大半，剩下的就是配置启动。
配置数据库——启动服务，建库建用户。还是拿 MySQL 举例：
```
sudo systemctl start mysql
sudo mysql_secure_installation
```
然后登录 MySQL 命令行，创建一个新用户和对应的数据库：
```
CREATE USER 'your_username'@'localhost' IDENTIFIED BY 'your_password';
CREATE DATABASE your_database_name;
GRANT ALL PRIVILEGES ON your_database_name.* TO 'your_username'@'localhost';
FLUSH PRIVILEGES;
EXIT;
```
记得把用户名、密码、数据库名换成你自己要用的。这一步很关键，权限给错了后面连不上，排查起来也麻烦。
安装 Node.js 数据库客户端库——在你的项目目录下，用 npm 安装对应的驱动。比如 MySQL 推荐用 mysql2：
```
npm install mysql2
```
PostgreSQL 则用 pg：
```
npm install pg
```
不同数据库的客户端库名字和用法略有差异，但大方向一致，装对了就能用。
在 Node.js 应用里配置连接——写代码的时候，连接信息最好通过环境变量或者配置文件来管理，别硬编码在源码里，这是安全底线。下面是一个用 mysql2 连接 MySQL 的示例：
```
const mysql = require('mysql2');
const connection = mysql.createConnection({
  host: 'localhost',
  user: 'your_username',
  password: 'your_password',
  database: 'your_database_name'
});

connection.connect(error => {
  if (error) throw error;
  console.log('Successfully connected to the database.');
});

// ... 进行数据库操作 ...

connection.end();
```
注意把 createConnection 里的参数改成你实际设置的值。如果连接失败，先检查数据库服务是否在运行，再检查用户名密码和权限。
跑起来验证——确保数据库服务已经启动（比如 sudo systemctl status mysql 看一下），然后运行你的 Node.js 程序。如果一切正常，控制台会输出连接成功的消息。如果报错，不要慌，根据错误信息一步步排查，十有八九是配置参数写错了或者服务没启动。