Sequelize 错误信息解决办法-JavaScript中文网-JavaScript教程资源分享门户

Sequelize 是一款 Node.js 下的 ORM 框架，用于操作关系型数据库。在使用 Sequelize 的过程中，会遇到各种错误信息，因为我们的程序总会有一些不可预知的因素出现，例如无法连接数据库、查询语句书写错误等等。本篇文章将针对常见的 Sequelize 错误信息进行分析和解决方案。

错误信息分析

错误信息示例

SequelizeConnectionError: connect ETIMEDOUT 127.0.0.1:3306

这是一个连接数据库的错误，要么是无法连接到指定的数据库地址和端口，要么是目标数据库服务异常，响应超时。

SequelizeDatabaseError: Unknown column 'name' in 'field list'

这是一个查询语句错误，要么是在某个表中找不到该列名，要么是该列名写错了，应该检查一下代码中是否该列名正确。

SequelizeValidationError: Validation error: Validation isEmail on email failed

这是一个模型验证错误，模型对象的某些属性没有通过验证器的校验，这里是邮箱验证不通过。

错误信息解决

对于无法连接数据库的错误，应该检查数据库的地址、端口和账号、密码等信息是否正确；对于查询语句错误，应该检查写错了哪个列名或者查询语句是否符合 SQL 语法规则；对于模型验证错误，应该检查模型对象中哪些属性没有通过验证器校验。

在解决错误信息之前，最好可以先打印出来错误对象的详细信息，这样有助于我们深入了解错误的本质以及如何解决，如下：

try {
  await User.create({ email: 'invalid-email' });
} catch (error) {
  console.error(error instanceof Sequelize.ValidationError);  // true
  console.error(error.message);  // Validation error: Validation isEmail on email failed
  console.error(error.errors);  // [ValidationErrorItem]
}

通过打印错误信息，可以得到错误类型、错误消息和错误对象数组，根据这些信息，我们就可以针对性地解决错误。

错误信息学习

当我们在工作中频繁遇到 Sequelize 的错误信息时，最好的方式是对这些错误信息进行分类、学习和总结。只有透彻理解每个错误发生的原因，我们才能有针对性地解决和避免这些错误。例如，下面给出一些错误信息的分类：

数据库连接错误
- SequelizeConnectionError: connect ETIMEDOUT 127.0.0.1:3306
- SequelizeConnectionRefusedError: connect ECONNREFUSED 127.0.0.1:3306
- SequelizeAuthenticationError: Access denied for user 'root'@'localhost' (using password: YES)
查询语句错误
- SequelizeDatabaseError: Unknown column 'name' in 'field list'
- SequelizeDatabaseError: ER_BAD_FIELD_ERROR: Unknown column 'email' in 'field list'
- SequelizeDatabaseError: You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near 'FROM Users AS User' at line 1
模型验证错误
- SequelizeValidationError: Validation error: Validation isEmail on email failed
- SequelizeValidationError: Validation error: Validation isIn on role failed

针对性地学习和总结这些错误信息，就能快速和准确地解决和避免这些错误，提高我们的工作效率。

错误信息指导

除了学习和解决错误信息之外，还需要总结一些编码时需要遵守的规范和最佳实践，这些都是从错误信息总结来的经验，例如：

对于数据库连接错误，应该检查数据库的地址、端口和账号、密码等信息是否正确，避免因为这些低级错误浪费时间。
对于查询语句错误，应该尽量使用 Sequelize 提供的 ORM 方法，避免手写 SQL 语句出错，ORM 方法可以帮助我们预防 SQL 注入等常见问题。
对于模型验证错误，应该明确模型对象的每个属性的校验规则并注释好，以便团队成员协作时能够快速了解哪些属性需要验证和验证规则，避免因为人为疏忽导致的错误。

最重要的一点是团队合作，多交流多总结，才能更好地避免和解决 Sequelize 的错误信息。

示例代码

为了更好地理解和运用本文所提到的内容，这里给出一个实际的示例代码，稍微解释一下它的作用：

const Sequelize = require('sequelize');

const sequelize = new Sequelize('database', 'username', 'password', {
  host: 'localhost',
  dialect: 'mysql',
  logging: false,
});

const User = sequelize.define('User', {
  email: {
    type: Sequelize.STRING,
    allowNull: false,
    unique: true,
    validate: {
      isEmail: true,
    },
  },
  password: {
    type: Sequelize.STRING,
    allowNull: false,
    validate: {
      notEmpty: true,
    },
  },
  role: {
    type: Sequelize.ENUM('user', 'admin'),
    allowNull: false,
    defaultValue: 'user',
    validate: {
      isIn: [['user', 'admin']],
    },
  },
});

(async () => {
  await sequelize.sync();
  console.log('Connected to database successfully!');

  try {
    await User.create({ email: 'invalid-email' });
  } catch (error) {
    console.error(error instanceof Sequelize.ValidationError);  // true
    console.error(error.message);  // Validation error: Validation isEmail on email failed
    console.error(error.errors);  // [ValidationErrorItem]
  }
})();

这个示例代码中，定义了一个 User 模型，包含了 email、password 和 role 三个属性。其中，email 需要满足是邮箱格式，password 不允许为空，role 必须是 ['user', 'admin'] 中的一个。在使用 User.create 方法向数据库插入一条数据时，如果 email 属性不满足邮箱格式，则会触发一个模型验证错误，我们可以通过上面所提到的方式来捕捉这个错误信息并进行处理。

总之，Sequelize 是一个功能强大且高效的 ORM 框架，但是在使用中会遇到各种错误，需要对这些错误进行总结和学习，并从编码角度去规避出现这些错误的可能性，才能更好地发挥 Sequelize 的优势，提高我们的工作效率。

来源：JavaScript中文网，转载请注明来源本文地址：https://www.javascriptcn.com/post/65a1dd5cadd4f0e0ff9f853e

Sequelize 错误信息解决办法