配置MySQL方言后Sequelize仍提示安装sqlite3的Node.js问题

我在运行 Node.js 项目时遇到报错：Error: Please install sqlite3 package manually，但明明已经在 Sequelize 连接配置里指定了 mysql 作为 dialect。以下是相关代码：

服务器代码 #

const sequelize = new Sequelize(process.env.DB_NAME, process.env.DB_USER, process.env.DB_PASS, {
 host: process.env.DB_HOST,
 port: process.env.DB_PORT,
 dialect: 'mysql'
});

sequelize.authenticate().then(() => {
app.listen(port, () => {
    // eslint-disable-next-line no-console
    console.log(`Example app listening on port ${port}`)
})
// eslint-disable-next-line no-unused-vars
}).catch((error) => {
  // eslint-disable-next-line no-console
  console.log(error);
  throw Error('Error in db connect');
});

package.json 代码 #

{
  "name": "geosafe-backend",
  "version": "1.0.0",
  "description": "",
  "main": "src/index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "dev": "node src/index",
    "format:check": "prettier --check .",
    "format:write": "prettier --write .",
    "lint:check": "eslint .",
    "lint:fix": "eslint --fix ."
 },
 "author": "Vinit Singh",
 "license": "ISC",
 "dependencies": {
   "bcryptjs": "^2.4.3",
   "dotenv": "^16.0.2",
   "express": "^4.18.1",
   "jsonwebtoken": "^8.5.1",
   "mysql2": "^2.3.3",
   "passport": "^0.6.0",
   "passport-jwt": "^4.0.0",
   "sequelize": "^6.21.4"
},
"devDependencies": {
  "eslint": "^8.23.0",
  "eslint-config-prettier": "^8.5.0",
  "prettier": "^2.7.1"
}
}

即使安装 sqlite3 包后，又遇到了表不存在的错误，怀疑是连接配置有问题，但找不到解决办法。

解决方案 #

• 检查环境变量加载情况
  确保代码开头已经执行 require('dotenv').config() 来加载 .env 文件，且文件内的 DB_NAME、DB_USER、DB_PASS、DB_HOST、DB_PORT 配置完全正确。如果环境变量未正确加载，Sequelize 会自动 fallback 到 sqlite 连接，这就是报错的核心原因。

• 排查是否存在重复的 Sequelize 初始化
  检查项目所有文件，确认没有其他地方重新初始化 Sequelize 实例并指定了 sqlite 作为 dialect，避免配置被覆盖。

• 重新安装 MySQL2 依赖
  虽然 package.json 已包含 mysql2，但可重新安装确保依赖无损坏：

  npm uninstall mysql2 && npm install mysql2
  

• 解决后续表不存在的问题
  连接成功后若提示表不存在，可从这两点排查：

  1. 要么手动在 MySQL 中创建对应表，要么在 Sequelize 初始化后调用 sequelize.sync() 开启自动同步（开发环境可用，生产环境建议用迁移）
  2. 检查模型定义的表名是否和数据库中一致，Sequelize 默认会将模型名转为复数表名，可在模型中添加 freezeTableName: true 关闭该默认行为

内容的提问来源于stack exchange，提问作者Ninja Turtle