GORM结合Echo与PostgreSQL开发CRUD时新建用户触发id非空约束错误

问题根因 #

从你贴的执行日志就能直接定位问题：PostgreSQL里的users表id列没有配置自动生成值的规则。
你看GORM生成的SQL：INSERT INTO "users" ("name","email") VALUES ('Joe Smith','joe.smith@example.com') RETURNING "id"，这说明GORM本身的自动逻辑是正常生效的——它识别到你传入的User结构体里ID是零值（打印调试输出也显示ID=0），所以自动跳过插入id字段，打算等数据库生成id后通过RETURNING子句回填到结构体里。
结果数据库这边根本不会主动给id列生成值，碰到没有默认值的非空列，自然抛出null值违反约束的错误。
你之前试了改主键标签、换标签写法、嵌gorm.Model、配UUID默认值都没解决，核心原因是这些操作全是在调整GORM代码层面的元数据识别，根本没有修改已经存在的数据库表结构：当初建表的时候id列就是普通的bigint NOT NULL，没绑定自增序列，不管GORM标签怎么写，数据库都不会凭空给id列赋值。另外GORM的AutoMigrate机制也不会主动去修改已存在表的列属性，哪怕你代码里写了自增标签，只要老表的列缺默认值，自动迁移也不会帮你补上。

修复操作步骤 #

• 先连到你的PostgreSQL实例，用\d users命令查看现有表结构，确认id列的属性：正常带自增的列会显示id bigint | not null default nextval('users_id_seq'::regclass)，你这里大概率是只有not null约束，没有default部分。
• 手动给现有表的id列补上自增配置，执行以下SQL即可：
  1. 创建和id列绑定的自增序列

     CREATE SEQUENCE IF NOT EXISTS users_id_seq;
     

  2. 把序列设置为id列的默认值

     ALTER TABLE users ALTER COLUMN id SET DEFAULT nextval('users_id_seq');
     

  3. 校准序列的起始值，避免插入时和表中已有id重复

     SELECT setval('users_id_seq', COALESCE((SELECT MAX(id) FROM users), 0) + 1, false);
     

• 后续修改模型定义，给主键明确加上自增标识，保证下次新建表时GORM能自动生成正确的列属性，不需要手动补SQL：

  type User struct {
      ID    int64  `json:"id" gorm:"primaryKey;autoIncrement"`
      Name  string `json:"name"`
      Email string `json:"email"`
  }
  

改完之后再执行之前的curl测试，GORM的Create操作就能正常拿到数据库生成的自增id了。

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