xorm 通过管理多个 engine 实例来实现多数据源切换。核心做法是调用 xorm.newengine() 分别连接不同的数据库,并将它们注册到同一个 store 中,随后在业务逻辑中根据条件选择对应的引擎执行操作。

如何初始化并注册多个数据源
初始化多数据源的关键在于创建独立的 Engine 对象。每个 Engine 代表一个独立的数据库连接池。你需要为每个数据源编写连接字符串,调用 xorm.NewEngine(driverName, dataSourceName) 生成引擎,并使用 engine.SetMapper() 设置表名映射规则(通常使用 xorm.GonicMapper{})。最后,将配置好的引擎添加到全局或局部的 Store 中,以便后续查找。

package main
import (
"fmt"
"log"
"github.com/go-xorm/xorm"
_ "github.com/go-sql-driver/mysql"
)
type Store struct {
engines map[string]*xorm.Engine
}
func NewStore() *Store {
return &Store{
engines: make(map[string]*xorm.Engine),
}
}
func (s *Store) AddEngine(name string, driver, dsn string) error {
engine, err := xorm.NewEngine(driver, dsn)
if err != nil {
return err
}
// 设置表名映射,例如 User 表对应 user 表
engine.SetMapper(xorm.GonicMapper{})
s.engines[name] = engine
return nil
}
func (s *Store) GetEngine(name string) (*xorm.Engine, error) {
engine, ok := s.engines[name]
if !ok {
return nil, fmt.Errorf("engine %s not found", name)
}
return engine, nil
}
func main() {
store := NewStore()
// 添加主库
if err := store.AddEngine("master", "mysql", "user:pass@tcp(127.0.0.1:3306)/db_master?charset=utf8mb4"); err != nil {
log.Fatal(err)
}
// 添加从库
if err := store.AddEngine("slave", "mysql", "user:pass@tcp(127.0.0.1:3306)/db_slave?charset=utf8mb4"); err != nil {
log.Fatal(err)
}
// 验证连接
masterEngine, _ := store.GetEngine("master")
if err := masterEngine.Ping(); err != nil {
log.Fatal("Master DB ping failed:", err)
}
slaveEngine, _ := store.GetEngine("slave")
if err := slaveEngine.Ping(); err != nil {
log.Fatal("Slave DB ping failed:", err)
}
fmt.Println("Multi-datasource initialized successfully.")
}
如何在业务代码中动态切换数据源
在业务层切换数据源时,不需要修改 ORM 的全局状态,而是直接获取对应的 Engine 实例并调用其方法。例如,写入操作使用 master 引擎的 Insert() 方法,读取操作使用 slave 引擎的 Find() 方法。你可以通过上下文、路由前缀或用户属性来决定使用哪个引擎。

type UserService struct {
store *Store
}
func (u *UserService) CreateUser(user *User) error {
// 切换到主库进行写入
engine, err := u.store.GetEngine("master")
if err != nil {
return err
}
_, err = engine.Insert(user)
return err
}
func (u *UserService) GetUser(id int64) (*User, error) {
// 切换到从库进行读取
engine, err := u.store.GetEngine("slave")
if err != nil {
return nil, err
}
var user User
has, err := engine.ID(id).Get(&user)
if err != nil {
return nil, err
}
if !has {
return nil, fmt.Errorf("user not found")
}
return &user, nil
}
// 假设的 User 结构体
type User struct {
ID int64 `xorm:"id pk autoincr"`
Name string `xorm:"name"`
}
基于事务场景下的多数据源切换问题
当业务涉及跨库事务时,XORM 的单个 Engine 只能管理单一数据库的事务。如果需要在两个不同数据源之间保持原子性,不能直接使用 XORM 内置的事务功能,因为 Begin() 仅作用于当前连接的引擎。此时需要手动管理两个数据库的连接,或者使用分布式事务方案。若仅是在同一事务内对同一数据源的不同表操作,则正常调用 engine.Begin() 即可。











