同时使用go-mssqldb与GORM遇SQL驱动重复注册panic的解决需求

错误原因 #

出现panic: sql: Register called twice for driver mssql的核心问题是代码中同时引入了两个实现SQL Server驱动的包：

• 手动导入的github.com/denisenkom/go-mssqldb（旧版SQL Server驱动）
• GORM的sqlserver驱动内部依赖的github.com/microsoft/go-mssqldb（微软官方维护的新版驱动）

这两个包都会调用database/sql.Register方法注册名为mssql的驱动，导致重复注册冲突。

解决方案 #

1. 移除重复的驱动导入 #

直接删除代码中手动导入的_ "github.com/denisenkom/go-mssqldb"，因为GORM的sqlserver驱动已经自动引入了官方维护的SQL Server驱动，无需额外导入旧版。

修改后的代码示例：

package main

import (
    "database/sql"
    "log"

    "gorm.io/driver/sqlserver"
    "gorm.io/gorm"
)

func main() {
    connString := "sqlserver://username:password@localhost:1433?database=yourdbname"

    // 初始化GORM连接
    gormDB, err := gorm.Open(sqlserver.Open(connString), &gorm.Config{})
    if err != nil {
        log.Fatal("Error connecting to database with GORM: ", err.Error())
    }

    // 从GORM实例中获取sql.DB连接池，供原生查询使用
    sqlDB, err := gormDB.DB()
    if err != nil {
        log.Fatal("Error getting sql.DB from GORM: ", err.Error())
    }
    defer sqlDB.Close()

    // 后续可同时使用gormDB执行ORM操作，sqlDB执行原生查询
}

2. 复用连接池（推荐） #

如果需要同时使用GORM和原生database/sql操作，优先从GORM实例中获取已初始化的sql.DB连接池，而非单独调用sql.Open。这种方式既避免了驱动冲突，又能复用同一个连接池，提升系统性能。

额外提示 #

• 你的场景中80%是CRUD及简单关联查询，GORM完全可以覆盖这些需求；剩余的原生查询也可通过GORM的Raw/Exec方法执行，无需维护两套连接逻辑。
• github.com/denisenkom/go-mssqldb已被微软接管，官方当前维护的版本为github.com/microsoft/go-mssqldb，GORM的sqlserver驱动默认依赖该新版，无需再导入旧版。

内容的提问来源于stack exchange，提问作者Firmansyah Yanuar