淺談express 連接在線數(shù)據(jù)庫踩坑

更新時間：2025年08月08日 10:46:13 作者：實習生小黃

本文記錄了連接遠程MySQL數(shù)據(jù)庫過程中遇到的常見問題及解決方案,包括用戶權限、防火墻、安全組、VPN等,具有一定的參考價值,感興趣的可以了解一下

1. 前言

在學習 Node.js 開發(fā)的過程中，Express 框架無疑是最受歡迎的選擇之一。

作為一名前端開發(fā)者，我決定深入學習后端技術，搭建一個完整的博客系統(tǒng)。

第一步自然是連接數(shù)據(jù)庫，而我選擇了連接遠程服務器上的 MySQL 數(shù)據(jù)庫，而不是在本地搭建環(huán)境。

這看似簡單的一步，卻讓我遇到了各種各樣的問題。

本文將記錄我在連接遠程 MySQL 數(shù)據(jù)庫過程中遇到的各種坑，希望能幫助到同樣遇到困難的開發(fā)者。

2. 如何連接

2.1 環(huán)境準備

首先，我們需要安裝必要的依賴：

npm install express mysql2 sequelize dotenv

2.2 配置文件

為了安全管理數(shù)據(jù)庫連接信息，我創(chuàng)建了 .env 文件來存儲敏感信息：

數(shù)據(jù)庫配置

DB_HOST=your_server_ip
DB_PORT=3306
DB_NAME=your_database_name
DB_USER=your_username
DB_PASSWORD=your_password

服務器配置

PORT=3000
NODE_ENV=development

2.3 數(shù)據(jù)庫連接配置

然后創(chuàng)建 config/database.js 文件：

const { Sequelize } = require('sequelize');
require('dotenv').config();

// 從環(huán)境變量獲取數(shù)據(jù)庫配置
const DB_HOST = process.env.DB_HOST || 'localhost';
const DB_PORT = process.env.DB_PORT || 3306;
const DB_NAME = process.env.DB_NAME || 'test_db';
const DB_USER = process.env.DB_USER || 'root';
const DB_PASSWORD = process.env.DB_PASSWORD || '';

// 創(chuàng)建 Sequelize 實例，連接到遠程數(shù)據(jù)庫
const sequelize = new Sequelize(
  DB_NAME,
  DB_USER,
  DB_PASSWORD,
  {
    host: DB_HOST,
    port: DB_PORT,
    dialect: 'mysql',
    pool: {
      max: 5,
      min: 0,
      acquire: 30000,
      idle: 10000
    },
    dialectOptions: {
      timezone: '+08:00'
    },
    logging: process.env.NODE_ENV !== 'production' ? console.log : false
  }
);

// 測試數(shù)據(jù)庫連接
const testConnection = async () => {
  try {
    await sequelize.authenticate();
    console.log('數(shù)據(jù)庫連接成功！');
  } catch (error) {
    console.error('無法連接到數(shù)據(jù)庫:', error);
  }
};

module.exports = {
  sequelize,
  testConnection
};

2.4 在應用中使用

在主應用文件 app.js 中：

require('dotenv').config();
const express = require('express');
const bodyParser = require('body-parser');
const cors = require('cors');
const { sequelize, testConnection } = require('./config/database');
const app = express();

// 中間件
app.use(cors());
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));

// 測試數(shù)據(jù)庫連接
testConnection();

// 路由
app.get('/', function (req, res) {
  res.send('hello, express');
});

// 啟動服務器
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`服務器運行在端口 ${PORT}`);
});

3. 問題

在實際連接過程中，我遇到了各種各樣的問題，下面逐一解決。

3.1 MySQL 用戶權限問題

問題現(xiàn)象：

Access denied for user ''@'localhost' (using password: YES)

解決方案：在 MySQL 服務器上創(chuàng)建允許遠程連接的用戶：

# 登錄 MySQL
mysql -u root -p

# 查看用戶權限
SELECT user, host FROM mysql.user WHERE user = 'yel_test';

# 如果用戶不存在，創(chuàng)建新用戶
CREATE USER 'yel_test'@'%' IDENTIFIED BY '123456';
GRANT ALL PRIVILEGES ON yel_test.* TO 'yel_test'@'%';

# 如果用戶已存在但只允許本地連接，添加遠程連接權限
GRANT ALL PRIVILEGES ON yel_test.* TO 'yel_test'@'%' IDENTIFIED BY '123456';

# 刷新權限
FLUSH PRIVILEGES;

3.2 MySQL 配置限制

問題現(xiàn)象：

ConnectionError [SequelizeConnectionError]: connect ETIMEDOUT

解決方案：修改 MySQL 配置文件（通常是 /etc/my.cnf），添加或修改 bind-address 設置：

查找配置文件

# 查找主要配置文件
cat /etc/my.cnf | grep bind-address

# 如果上面沒有結果，查看是否有包含的配置目錄
cat /etc/my.cnf | grep "!includedir"


# 修改配置文件
vi /etc/my.cnf

如果使用 vi 但不熟悉：

按 i 進入插入模式
移動到 [mysqld] 部分下方
添加 bind-address = 0.0.0.0
按 Esc 退出插入模式
輸入 :wq 保存并退出（或 :q! 不保存退出）

然后重啟 MySQL 服務：

systemctl restart mysqld
# 或
service mysqld restart

3.4 防火墻限制

問題現(xiàn)象：

無法連接到數(shù)據(jù)庫，但可以 ping 通服務器。

解決方案：

檢查并開放服務器防火墻的 MySQL 端口（默認 3306）：

# 查看防火墻規(guī)則
firewall-cmd --list-all | grep 3306

# 如果沒有開放，添加規(guī)則
firewall-cmd --zone=public --add-port=3306/tcp --permanent
firewall-cmd --reload