首页 > 编程语言 >Ubuntu NodeJS数据库连接配置步骤

Ubuntu NodeJS数据库连接配置步骤

来源：互联网 2026-07-02 08:18:05

在Ubuntu上配置Node.js数据库连接的整体流程：首先安装Node.js和npm，之后安装并配置MongoDB、MySQL或PostgreSQL等数据库。然后通过npm安装对应的数据库驱动，编写连接代码并启动应用。最后检查数据库服务状态，解决常见错误如数据库服务未启动、端口占用、认证失败等问题，以确保连接成功。

在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();

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