Sequelize操作PostgreSQL提示phoneNumber列不存在的问题求助

1. 检查字段名的命名映射问题 #

PostgreSQL 默认使用蛇形命名（如phone_number），而 Sequelize 默认会将模型中的驼峰字段（phoneNumber）自动转换为蛇形命名。如果你的数据库表实际列名是phoneNumber（驼峰），但 Sequelize 生成的 SQL 会查询phone_number，就会触发报错。

• 排查操作：在 PSQL 终端执行\d contacts，查看表的实际列名是phoneNumber还是phone_number。
• 解决方法：
  • 若表列是phone_number：模型中保持phoneNumber即可，Sequelize 会自动完成驼峰转蛇形的映射。
  • 若表列是phoneNumber：在模型中手动指定实际列名，关闭自动转换：

    // contacts.js 模型定义
    const Contact = sequelize.define('Contact', {
      phoneNumber: {
        type: DataTypes.STRING,
        field: 'phoneNumber' // 指定数据库中实际列名
      }
      // 其他字段定义...
    }, {
      underscored: false // 全局关闭驼峰转蛇形，或仅给单个字段加field配置
    });
    

2. 确认模型与数据库表的关联匹配 #

• 检查表名是否一致：Sequelize 默认会将模型名（如Contact）转换为复数小写的表名（contacts），如果你的数据库表名是Contacts（首字母大写），需要手动指定：

  const Contact = sequelize.define('Contact', {
    // 字段定义...
  }, {
    tableName: 'Contacts' // 填写数据库中实际的表名
  });
  

• 如果你是手动创建的表（未使用 Sequelize 的sync()或迁移工具），需确保模型字段的类型、非空约束等与数据库表列完全一致。

3. 查看 Sequelize 生成的实际 SQL #

开启 Sequelize 的日志功能，直接查看执行的 SQL 语句，就能明确到底查询的是哪个列：

// 初始化 Sequelize 时开启日志
const sequelize = new Sequelize('database', 'username', 'password', {
  host: 'localhost',
  dialect: 'postgres',
  logging: console.log // 打印所有执行的 SQL 语句
});

发起请求后，观察控制台输出的 SQL 中 WHERE 条件使用的列名，与数据库实际列名对比即可定位问题。

4. 排查 PostgreSQL 的大小写敏感问题 #

PostgreSQL 如果创建表时未使用双引号，列名会自动转换为全小写。比如执行CREATE TABLE Contacts (phoneNumber VARCHAR(20));，实际列名是phonenumber，此时 Sequelize 查询phoneNumber或phone_number都会报错。

• 排查操作：在 PSQL 执行以下语句查看实际列名：

  SELECT column_name FROM information_schema.columns WHERE table_name = 'contacts';
  

• 解决方法：要么修改模型字段名匹配实际小写列名，要么重新创建表时用双引号指定大小写（不推荐，PostgreSQL 更推荐蛇形命名）：

  CREATE TABLE Contacts ("phoneNumber" VARCHAR(20));
  

5. 确认模型是否正确加载 #

检查 Express 路由中是否正确导入了 Contacts 模型，有没有拼写错误（比如把Contacts写成Contact），导致使用了错误的模型进行查询。

内容的提问来源于stack exchange，提问作者Amritanshu SINGH