如何在Golang中忽略Struct未定义的数据库字段避免插入报错

以下分两种常用开发场景给出可落地的处理方案：

场景1：使用GORM作为ORM框架 #

GORM默认执行创建、更新操作时，只会读取结构体中声明的、未被标记忽略的字段生成SQL语句，不会自动拼接数据库中存在但结构体未定义的字段。你遇到的报错核心原因是新增的salary字段设置了NOT NULL约束且没有配置默认值，即使插入语句不涉及该字段，MySQL也会强制要求非空字段传入有效值，你可以先做基础配置：

• 后续所有新增的数据库字段，要么设置允许为NULL，要么配置对应数据类型的默认值，从数据库层面避免非空约束报错。

如果需要更稳妥的字段过滤能力，可以用以下两种配置：

• 单操作显式指定插入字段，调用Select方法明确要写入的字段范围，不受表结构变更影响：

// 仅插入Name、Age两个字段，忽略表中其他所有字段
db.Model(&Employee{}).Select("Name", "Age").Create(&empObj)

• 全局自定义字段过滤逻辑，通过GORM的Hook机制自动过滤所有结构体中未定义的字段，无需每次操作手动指定字段。

场景2：使用原生database/sql或轻量ORM #

你需要自行封装SQL生成逻辑，通过反射动态读取结构体的字段标签（一般用db标签标记数据库字段名），仅使用结构体中存在的字段生成INSERT语句，不要写死全字段的插入SQL：

// 反射读取结构体绑定的数据库字段列表
func getDBFields(model interface{}) []string {
    t := reflect.TypeOf(model).Elem()
    var fields []string
    for i := 0; i < t.NumField(); i++ {
        fieldTag := t.Field(i).Tag.Get("db")
        if fieldTag == "" || fieldTag == "-" {
            continue
        }
        fields = append(fields, fieldTag)
    }
    return fields
}

// 动态生成插入语句
fields := getDBFields(&empObj)
placeholders := make([]string, len(fields))
for i := range placeholders {
    placeholders[i] = "?"
}
insertSQL := fmt.Sprintf("INSERT INTO employee (%s) VALUES (%s)",
    strings.Join(fields, ","),
    strings.Join(placeholders, ","),
)

注意：禁止使用INSERT INTO 表名 VALUES (?,?,?)这种省略字段列表的写法，该写法要求传入和表字段数量完全匹配的参数，只要表新增字段就会触发报错。

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