Go Fiber+GORM项目PostgreSQL users表不存在报错求助

针对你遇到的PostgreSQL提示relation "users" does not exist错误，结合你使用的Go Fiber、GORM、Go migrate、GORM Gen和Viper技术栈，大概率是配置层面的表名/数据库匹配问题，以下是具体排查点：

1. 数据库Schema匹配问题 #

PostgreSQL默认使用public schema，若migrate脚本指定了其他schema，或GORM连接未指定搜索路径，会导致表找不到：

• 检查migrate脚本的建表语句，确认是否带了正确的schema前缀（例如CREATE TABLE public.users (...)）
• 查看Viper加载的DSN配置，是否包含search_path参数，示例：

  host=localhost user=postgres password=xxx dbname=your_db port=5432 sslmode=disable search_path=public
  

• 或者在GORM初始化时显式指定Schema前缀：

  db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{
    NamingStrategy: schema.NamingStrategy{
      TablePrefix: "public.",
    },
  })
  

2. GORM Gen表名映射不一致 #

GORM Gen生成的Model可能和migrate创建的表名不匹配：

• 检查Gen生成的Model结构体，是否存在TableName()方法，返回的表名是否与migrate创建的完全一致（注意PostgreSQL表名默认小写，若Gen配置或结构体标签指定了不同表名会出错）
• 例如若结构体加了gorm:"table:user"标签，而migrate创建的是users表，就会触发该错误

3. 数据库连接实例不匹配 #

确认GORM连接的数据库和migrate执行的是同一个：

• 对比Viper加载的数据库配置（库名、端口、用户）和migrate命令使用的参数，确保完全一致
• 比如migrate操作的是prod_db，但GORM连接的是dev_db，自然找不到已创建的表

4. 表名大小写问题 #

PostgreSQL对表名大小写敏感，若migrate创建的表名是大写（如Users），而GORM默认查询小写users，会报错：

• 用psql连接目标数据库，执行\dt命令查看表名的实际大小写
• 若存在大小写差异，要么修改migrate脚本统一表名，要么在GORM配置中指定准确的表名

5. GORM命名策略配置错误 #

GORM的默认命名策略可能导致表名与migrate创建的不一致：

• 检查GORM初始化时的NamingStrategy配置，若开启了SingularTable: true，GORM会查询单数表名user，但migrate创建的是复数users，就会出现错误：

  &gorm.Config{
    NamingStrategy: schema.NamingStrategy{
      SingularTable: true, // 该配置会将表名设为单数
    },
  }
  

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