如何在Ubuntu上配置NodeJS数据库连接

在Ubuntu上，把Node.js应用和数据库连起来，其实就那么几步。别看市面上各种教程写得天花乱坠，核心的流程和逻辑是固定的。今天就把它掰开揉碎，从零开始走一遍，保证你心里有谱。

先把Node.js环境搭起来

如果你的机器上还没装Node.js，别想复杂了，直接通过包管理器搞定就行：

sudo apt update
sudo apt install nodejs npm

装好之后记得验证一下，node -v 和 npm -v 能正常输出版本号，这一步才算稳了。

数据库选型与安装

这一步完全看你的项目需求。拿几个主流的选择来说：

MongoDB —— 适合文档型数据，上手快：

sudo apt install -y mongodb

MySQL —— 传统关系型数据库的常青树：

sudo apt install mysql-server

PostgreSQL —— 功能强大，尤其适合复杂查询：

sudo apt install postgresql postgresql-contrib

装好只是第一步，关键是后续的配置——不同的数据库，脾气秉性可不一样。

数据库配置：别跳过这一步

安装完数据库，不代表就能直接连。需要根据各自的文档做点初始化工作。

以MongoDB为例，你得先启动服务：

sudo systemctl start mongod

如果用的是MySQL，强烈建议跑一下安全设置脚本：

sudo mysql_secure_installation

至于PostgreSQL，通常需要手动创建一个数据库用户，并授予相应的权限。很多人栽在这一步，以为装完就能用，结果发现连接被拒。

安装对应的Node.js驱动

Node.js本身不会自带数据库驱动，你得通过npm安装对应的客户端库。

• MongoDB 用 mongoose：npm install mongoose
• MySQL 推荐 mysql2：npm install mysql2
• PostgreSQL 用 pg：npm install pg

这里多说一句，选对库很重要，社区主流的这些经过大量项目验证，坑会少很多。

编写连接代码

终于到了真正写代码的部分。以下几个示例基本覆盖了最常见的场景：

MongoDB（使用mongoose）：

const mongoose = require('mongoose');
mongoose.connect('mongodb://localhost:27017/mydatabase', {
  useNewUrlParser: true,
  useUnifiedTopology: true
});

const db = mongoose.connection;
db.on('error', console.error.bind(console, 'connection error:'));
db.once('open', function() {
  // connected to database
});

MySQL（使用mysql2）：

const mysql = require('mysql2');
const connection = mysql.createConnection({
  host: 'localhost',
  user: 'yourusername',
  password: 'yourpassword',
  database: 'mydatabase'
});

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

PostgreSQL（使用pg）：

const { Client } = require('pg');
const client = new Client({
  user: 'yourusername',
  host: 'localhost',
  database: 'mydatabase',
  password: 'yourpassword',
  port: 5432,
});
client.connect();

这段代码看起来简单，但实际开发中容易踩的坑往往是参数写错、端口不对，或者数据库服务没启动。

运行起来

确保数据库服务已经正常运行，然后启动你的Node.js应用：

node app.js

如果一切顺利，控制台会打印出连接成功的消息。如果报错，先别慌——检查一下数据库服务状态、用户名密码、连接字符串，80%的问题都能在这几个环节解决。

说到底，在Ubuntu上配置Node.js数据库连接，本质上就是一个“装环境、装驱动、写代码、调参数”的循环。遇到具体问题，翻一翻官方文档，比在网上找碎片化的答案要靠谱得多。