Sequelize操作PostgreSQL时出现‘users表不存在’错误求助

错误信息 #

2023-03-29 03:23:14.966 UTC [44] ERROR: relation "users" does not exist at character 13

这个错误说明PostgreSQL数据库中不存在名为users的表，即便你在Sequelize模型中定义了该表，也可能是以下原因导致：

1. 数据库连接配置错误（关键bug） #

你的database.ts中host参数错误地使用了DB_NAME环境变量，这会导致Sequelize连接到错误的主机（甚至无效主机），自然找不到目标数据库里的users表：

// 错误代码
host: process.env.DB_NAME!,

// 修正为
host: process.env.DB_HOST!,

请确保DB_HOST环境变量已正确配置为PostgreSQL服务器地址（比如localhost或远程服务器IP）。

2. 模型未同步到数据库 #

Sequelize的模型定义仅存在于代码层面，不会自动在数据库中创建表。你需要手动触发同步操作：

方案1：开发环境快速同步

在项目启动文件中添加同步逻辑，确保服务器启动前完成模型与数据库的同步：

import sequelize from './database.js';
import User from './models/user.js';
import express from 'express';

const app = express();

async function startServer() {
  try {
    // 同步所有模型到数据库
    // force: true会删除已存在的表并重建，仅用于开发环境测试
    // 生产环境请设为false或使用迁移工具
    await sequelize.sync({ force: false });
    console.log('数据库模型同步完成');
    
    app.use(express.json());
    // 挂载路由...
    
    app.listen(3000, () => {
      console.log('服务器运行在 http://localhost:3000');
    });
  } catch (error) {
    console.error('数据库同步失败:', error);
  }
}

startServer();

方案2：生产环境迁移（推荐）

对于生产环境，建议使用Sequelize迁移工具管理表结构变更，避免数据丢失：

• 初始化迁移：npx sequelize-cli init
• 创建迁移文件：npx sequelize-cli model:generate --name User --attributes userName:string,password:string,email:string,dob:date
• 执行迁移：npx sequelize-cli db:migrate

3. 数据库模式（Schema）不匹配 #

PostgreSQL默认使用public模式，如果你的users表创建在其他模式下，需要在模型中明确指定：

User.init(
  // 字段定义...
  {
    sequelize,
    tableName: 'users',
    freezeTableName: true,
    schema: 'public' // 替换为你的实际模式名称
  }
);

同时要确保数据库用户有访问该模式的权限。

4. 表名大小写问题 #

PostgreSQL会将未加双引号的标识符自动转为小写，如果你手动创建表时用了大写（比如Users），而模型中定义的是users，会导致找不到表。通过freezeTableName: true已锁定表名为users，只需确保数据库中实际表名是小写的users即可。

内容的提问来源于stack exchange，提问作者Bhanu Prakash War