使用GORM无法将数据插入PostgreSQL菜单表的原因及解决方案

本文针对使用Go语言GORM库向PostgreSQL数据库的menu表插入数据失败的问题，提供详细的排查和解决方法。 问题源于Go语言结构体`MenuModel`中`State`字段类型与数据库表中`state`列类型不匹配，导致GORM无法正确编码数据。文章分析了数据库连接、模型定义、表结构、插入语句、权限和事务等多个可能导致插入失败的原因，并最终通过将`State`字段类型修改为`string`解决了问题，避免了整数直接插入varchar列的类型错误。 此外，文章还提供了数据库表结构定义、连接配置、Go语言结构体定义以及插入数据代码示例，方便读者理解和实践。

Go语言GORM库无法向PostgreSQL数据库插入数据的排查

本文探讨使用Go语言和GORM库操作PostgreSQL数据库时遇到的一个问题：尝试向menu表插入数据失败，报错“failed to encode args[3]: unable to encode 1 into text format for varchar (oid 1043): cannot find encode plan”。

数据库表结构 (DDL)

数据库表menu的定义如下：

CREATE TABLE "public"."menu" (
  "id" int4 NOT NULL GENERATED ALWAYS AS IDENTITY (
    INCREMENT 1
    MINVALUE 1
    MAXVALUE 2147483647
    START 1
  ),
  "title" varchar(255) COLLATE "pg_catalog"."default",
  "router" varchar(255) COLLATE "pg_catalog"."default",
  "state" varchar(255) COLLATE "pg_catalog"."default",
  "sort" int4,
  "icon" varchar(255) COLLATE "pg_catalog"."default",
  "created_at" timestamp(6),
  "updated_at" timestamp(6),
  "sid" int4 NOT NULL DEFAULT 0
);

ALTER TABLE "public"."menu" OWNER TO "postgres";

COMMENT ON COLUMN "public"."menu"."title" IS '标题';
COMMENT ON COLUMN "public"."menu"."router" IS '路由';
COMMENT ON COLUMN "public"."menu"."state" IS '状态';
COMMENT ON COLUMN "public"."menu"."sort" IS '排序';
COMMENT ON COLUMN "public"."menu"."icon" IS '图标';
COMMENT ON TABLE "public"."menu" IS '菜单表';

数据库连接配置

数据库连接代码如下：

dsn := "host=xxxx user=postgres password=xxxxx dbname=xxxx port=5432 sslmode=disable timezone=Asia/Shanghai"
db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
if err != nil {
    // 处理错误
}

Go语言结构体定义

对应的Go语言结构体：

type MenuModel struct {
    ID         int       `gorm:"column:id"`
    Title      string    `gorm:"column:title"`
    Router     string    `gorm:"column:router"`
    Sid        int       `gorm:"column:sid"`
    State      int       `gorm:"column:state"` // 问题所在
    Sort       int       `gorm:"column:sort"`
    Icon       string    `gorm:"column:icon"`
    CreatedAt  time.Time `gorm:"column:created_at;autoCreateTime"`
    UpdatedAt  time.Time `gorm:"column:updated_at;autoUpdateTime"`
}

插入数据操作

插入数据的代码：

initdb() // 初始化数据库连接
menu := MenuModel{
    Title:  "1",
    Router: "1",
    Sid:    1,
    State:  1, // 问题所在
    Sort:   1,
    Icon:   "1",
}
db.Create(&menu)
fmt.Println(menu.ID)

错误分析与解决方法

错误信息提示无法将整数1编码为varchar类型。仔细对比数据库表结构和Go语言结构体定义，发现问题在于MenuModel结构体的State字段类型为int，而数据库表中的state列类型为varchar。 这导致GORM尝试将整数直接插入到varchar列中，引发类型不匹配错误。

解决方法是将MenuModel结构体的State字段类型修改为string：

type MenuModel struct {
    ID         int       `gorm:"column:id"`
    Title      string    `gorm:"column:title"`
    Router     string    `gorm:"column:router"`
    Sid        int       `gorm:"column:sid"`
    State      string    `gorm:"column:state"` // 修改为string
    Sort       int       `gorm:"column:sort"`
    Icon       string    `gorm:"column:icon"`
    CreatedAt  time.Time `gorm:"column:created_at;autoCreateTime"`
    UpdatedAt  time.Time `gorm:"column:updated_at;autoUpdateTime"`
}

修改后，GORM将正确地将字符串"1"插入到数据库的state列中。 此外，GORM的标签可以简化，因为GORM会根据字段名自动推断列名。

通过这个修改，应该可以解决数据插入问题。 记住处理gorm.Open函数可能返回的错误。

理论要掌握，实操不能落！以上关于《使用GORM无法将数据插入PostgreSQL菜单表的原因及解决方案》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！