Beego 1.x 的 InsertMulti 不支持结构体切片,须传 [][]interface{} 或 []map[string]interface{};需用 reflect 动态提取导出字段值,跳过 tag 为-或pk且值为零的字段,并处理指针与特殊类型。

Beego 中 InsertMulti 的正确用法
Beego 1.x 的 ORM 提供了 InsertMulti 方法用于批量插入,但它不接受结构体切片,只接受二维 []interface{} 或 []map[string]interface{}。直接传 []*User 会 panic:「unsupported type」。
常见错误是照搬单条 Insert 写法,误以为传结构体切片就能自动展开字段:
o := orm.NewOrm()
users := []*User{{Name: "a"}, {Name: "b"}}
_, err := o.InsertMulti(100, users) // ❌ panic
- 必须手动提取字段值,组装成
[]interface{}切片,每项是[]interface{}(对应一行) - 字段顺序必须严格匹配模型定义顺序(或显式指定
orm.RegisterModelWithPrefix后的列序) - 如果模型含自增主键,该字段值应设为
0或nil,否则可能触发唯一冲突
用 reflect 动态提取结构体字段值
硬编码字段名易出错且难维护,尤其字段多或常变动时。用 reflect 可通用处理任意结构体,但要注意性能和空指针风险。
关键点:
- 只遍历导出字段(首字母大写),跳过
ormtag 为-或pk且值为零值的字段(如自增 ID) - 对
*time.Time、sql.NullString等需单独判断并调用.Value或.Time - 避免对
nil指针直接reflect.ValueOf(x).Elem(),先检查IsValid和IsNil
示例节选(非完整函数):
func structToRow(v interface{}) []interface{} {
rv := reflect.ValueOf(v)
if rv.Kind() == reflect.Ptr { rv = rv.Elem() }
var row []interface{}
for i := 0; i < rv.NumField(); i++ {
fv := rv.Field(i)
if !fv.CanInterface() { continue }
row = append(row, fv.Interface())
}
return row
}
InsertMulti 的事务与错误处理
Beego ORM 的 InsertMulti 默认不开启事务,单条失败会导致部分数据写入,且返回的 int64 是实际插入行数,不是“成功数”。错误类型通常是 *mysql.MySQLError,需断言判断是否为重复键(errno 1062)或连接中断。
- 若需原子性,必须手动用
o.Begin()+defer o.Rollback()包裹 - 超过 1000 行建议分批(如每 500 行一次
InsertMulti),避免 MySQL packet size 超限(ERROR 1153 (08S01): Got a packet bigger than 'max_allowed_packet' bytes) - 不要依赖返回值判断全部成功——要检查
err != nil,而非仅比对行数
替代方案:原生 SQL + Exec 拼接
当 InsertMulti 灵活性不足(如需 ON DUPLICATE KEY UPDATE)或性能要求极高时,绕过 ORM 直接拼 SQL 更可控。Beego 的 Raw 支持参数绑定,但批量插入的占位符需动态生成。
例如:
values := make([]string, len(users))
params := make([]interface{}, 0, len(users)*2)
for _, u := range users {
values[i] = "(?, ?)"
params = append(params, u.Name, u.Age)
}
sql := "INSERT INTO user (name, age) VALUES " + strings.Join(values, ",")
_, err := o.Raw(sql, params...).Exec()
- 注意
strings.Join拼接的VALUES部分不能超过 MySQL 单次 query 长度限制 - 字段名和值顺序必须一致,且需过滤 SQL 注入风险(仅限可信数据,或改用
fmt.Sprintf配合白名单字段) - 此方式无法复用 Beego 的 hook(如
PreInsert),需自行补全时间戳等逻辑
真正麻烦的从来不是语法,而是字段顺序一致性、空值处理、以及分批边界下事务与错误码的耦合。别省那几行反射代码,也别迷信 ORM 的“自动”——批量插入里,最稳的永远是看得到每一列怎么来的那一版。


















