Go 語言使用 XORM 操作 MySQL 的陷阱
01 介紹
在 Go 語言開發中，大家為了方便，通常會選擇使用 ORM 操作數據庫，比如使用 XORM 或 GORM 操作 MySQL。
雖然使用 ORM 操作 MySQL 比直接使用標準庫 `sql`[1] 和三方 MySQL 數據庫驅動包[2]操作 MySQL 更加方便，但是也會遇到一些陷阱。
本文我們來介紹一下使用 XORM[3] 操作 MySQL 可能會遇到的陷阱。
02 使用 XORM 操作 MySQL 的陷阱
類型零值
在 Golang 中，每個數據類型都有各自的類型零值，比如 int 的零值是 0，string 的零值是 ''等。
示例代碼：
package main
import (
"fmt"
_ "github.com/go-sql-driver/mysql"
"xorm.io/xorm"
)
func main() {
// 創建 Engine
engine, err := xorm.NewEngine("mysql", "root:root@/example?charset=utf8")
defer func() {
err = engine.Close()
if err != nil {
fmt.Printf("engine close err=%v\n", err)
return
}
}()
if err != nil {
fmt.Printf("init xorm engine fail, err=%v\n", err)
return
}
// 更新數據
example := &Example{
Title: "go",
View: 0,
}
condi := &Example{
Id: 2,
}
affected, err := engine.Update(example, condi)
if err != nil {
fmt.Printf("Update err=%v\n", err)
return
}
fmt.Printf("affected=%d\n", affected)
}
type Example struct {
Id int `json:"id" form:"id"`
Title string `json:"title" form:"title"`
View int `json:"view" form:"view"`
Created int `json:"created" form:"created" xorm:"created"`
Updated int `json:"updated" form:"updated" xorm:"updated"`
}閱讀上面這段代碼，我們可以發現示例代碼中將 id=2 的數據 view 字段更新為 0，因為 0 是 int 的類型零值，XORM 的 Update 方法會自動忽略類型零值，所以該數據 view 字段的值沒有更改。
但是，在實際項目開發中，我們可能需要將某個字段的值更新為該字段類型的類型零值，此時我們該怎么操作呢？
affected, err := engine.Cols("title", "view").Update(example, condi)我們可以使用 Cols() 方法，指定需要更新的字段，這樣即便需要更新字段的值是該字段類型的類型零值，也可以正常更改。
提示：建議在設計數據庫表時，字段的值盡量使用非類型零值。
自增 id
在插入數據時，我們可能需要返回自增 id，我們先看一段代碼：
// 插入數據
example := &Example{
Title: "PHP",
View: 90,
}
affected, err := engine.Insert(example)
if err != nil {
fmt.Printf("Insert err=%v\n", err)
return
}
fmt.Printf("affected=%v\n", affected)閱讀上面這段代碼，我們插入一條數據，返回結果是影響行數和錯誤信息，而不是直接返回該條數據的自增 id。
可能有些讀者朋友們會接著使用查詢方法，查詢最新一條數據的 id，在并發請求數低的場景中，該方法是可以查到新插入數據的自增 id。
但是在并發請求數高的場景中，該方法查到的最新一條數據的 id，未必是我們剛插入的數據的自增 id。
id := example.Id
fmt.Printf("affected=%v || id=%d\n", affected, id)閱讀上面這段代碼，我們想要獲取新插入數據的自增 id，直接 example.Id 即可獲取，但是前提條件是結構體中，id 字段使用 xorm:"autoincr" 標簽。
更新 created 字段
我們在結構體中，使用標簽 xorm:created 和 xorm:updated 即可自動插入當前時間。
但是，使用 xorm:created 標簽的字段，只有在第一次插入數據時寫入當前時間，此后將不再會更改；使用 xorm:updated 標簽的字段，在第一次插入數據時寫入當前時間，此后每次 Update 操作，時間都會更改。
如果我們的業務需求是需要更改使用 xorm:created 標簽的字段，可以做到嗎？
// 更改數據
example := &Example{
Title: "JavaScript",
View: 98,
}
condi := &Example{
Id: 2,
}
affected, err := engine.Update(example, condi)
if err != nil {
fmt.Printf("Update err=%v\n", err)
return
}
fmt.Printf("affected=%d\n", affected)閱讀上面這段代碼，我們發現執行 Update 方法之后，使用 xorm:updated 標簽的字段的值被更改，而使用 xorm:created 標簽的字段的值沒被更改。
我們換一種更新數據的方式，代碼如下：
// 更改數據
sql := "UPDATE example SET title=?, view=?, created=? WHERE id=?"
res, err := engine.Exec(sql, "Python", 60, time.Now().Unix(), 2)
if err != nil {
fmt.Printf("Update err=%v\n", err)
return
}
affected, err := res.RowsAffected()
if err != nil {
fmt.Printf("RowsAffected err=%v\n", err)
return
}
fmt.Printf("affected=%d\n", affected)閱讀上面這段代碼，我們可以發現使用 Exec 方法執行原生 SQL 可以滿足我們的需求。
03 總結
本文我們介紹了使用 XORM 操作 MySQL 時，新手讀者朋友們可能會遇到的陷阱，希望可以給大家帶來一些幫助。
讀者朋友們在使用 XORM 或 GORM 操作 MySQL 時，還遇到過哪些陷阱，歡迎讀者朋友們在留言區分享。
