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

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

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

1. 前言

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

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

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

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

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

2. 如何連接

2.1 環(huán)境準(zhǔ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

服務(wù)器配置

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í)例，連接到遠(yuǎn)程數(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 在應(yīng)用中使用

在主應(yīng)用文件 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');
});

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

3. 問題

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

3.1 MySQL 用戶權(quán)限問題

問題現(xiàn)象：

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

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

# 登錄 MySQL
mysql -u root -p

# 查看用戶權(quán)限
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'@'%';

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

# 刷新權(quán)限
FLUSH PRIVILEGES;

3.2 MySQL 配置限制

問題現(xiàn)象：

ConnectionError [SequelizeConnectionError]: connect ETIMEDOUT

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

查找配置文件

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

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


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

如果使用 vi 但不熟悉：

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

然后重啟 MySQL 服務(wù)：

systemctl restart mysqld
# 或
service mysqld restart

3.4 防火墻限制

問題現(xiàn)象：

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

解決方案：

檢查并開放服務(wù)器防火墻的 MySQL 端口（默認(rèn) 3306）：

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

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