gorm v2 不支持自定义驱动，仅支持自定义插件；驱动必须实现 gorm.dialector 接口并作为独立包发布，而插件通过 register(*gorm.db) 注册且不继承于 session/事务等派生实例。
直接说结论：GORM v2 不支持自定义驱动，但完全支持自定义插件；所谓“自定义驱动”实际是误传或混淆了概念——GORM 的驱动层由 gorm.io/driver/* 实现，必须满足 gorm.ConnPool 接口并导出 Open 函数，无法通过插件机制替换。
为什么你搜到的“自定义驱动”示例大多失效或报错
常见错误现象：cannot use myDriver (type *MyDriver) as type gorm.Dialector 或启动时 panic 提示 unsupported driver: xxx。
根本原因在于 GORM v2 彻底重构了驱动模型：它不再接受任意结构体作为驱动，而是强制要求实现 gorm.Dialector 接口（含 Name()、Initialize(*gorm.Config) error 等方法），且必须通过 gorm.Open(dialector, config) 初始化，而非旧版的 gorm.Open("driver", dsn)。
你看到的很多博客示例仍基于 GORM v1（github.com/jinzhu/gorm），其驱动注册方式已废弃。v2 的驱动必须是独立包（如 gorm.io/driver/mysql），不能在业务代码里“手写一个驱动结构体然后 db.Use()”。
- 驱动 ≠ 插件：驱动负责连接、执行原始 SQL、管理连接池；插件只作用于
*gorm.DB生命周期，无法触达底层网络或协议层 - 想对接非标准数据库（如某国产信创库）？必须单独建 repo 实现
gorm.Dialector，发布为 Go module，再import _ "your-org/your-driver" - 试图用插件“模拟驱动行为”（比如拦截所有
Exec并转发到 HTTP API）会失败：插件回调函数接收的是*gorm.DB，不是底层sql.Conn或sql.Tx
真正能动手写的只有插件：从 Register 到 Initialize 的关键分界
插件必须实现 gorm.Plugin 接口，但注意：GORM v2 文档和部分老资料仍写的是 Initialize(*gorm.DB) error，而最新稳定版（v2.2+）实际要求的是 Register(*gorm.DB) error ——这是最常踩的坑。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
如果你写了 Initialize 却发现插件完全没触发，大概率是因为用了新版 GORM 但按旧教程编码。
-
Register是唯一入口：所有回调注册、状态初始化、依赖检查都必须放在这里，GORM 不会调用任何其他方法 - 不要在
Register里做耗时操作：比如连 Redis、读配置文件、建表。这些应放在应用启动后、db.Use()之前完成 - 插件实例本身不应保存状态：因为
*gorm.DB是链式复制的，每次db.Where(...).First()都可能生成新实例，状态应存入tx.Statement.Context或用tx.InstanceSet("key", value) - 回调函数签名严格限定为
func(*gorm.DB)：不能带 context、error 或其他参数，否则注册时静默失败
插件生效范围陷阱：Session、WithContext、事务都会断掉继承链
典型问题：你在全局 db 上 Use(&AuditPlugin{})，但 db.Session(&gorm.Session{}).Create(&u) 完全不触发审计逻辑。
这是因为 GORM 的插件注册是“单实例绑定”的：插件只注入到调用 Use() 的那个 *gorm.DB 实例及其直接派生链（如 db.Table("x")）。一旦使用 Session、WithContext、Scopes 或开启事务（db.Begin()），新生成的 *gorm.DB 默认不继承已注册插件。
- 解决办法只有显式传播：比如封装一个
WithPlugins(db *gorm.DB) *gorm.DB函数，在里面重新Use()所有必需插件 - 或者改用全局回调注册：直接调用
gorm.DefaultCallback.Create().Before(...).Register(...)，但这会污染所有 DB 实例，不推荐 - 事务内插件失效？别依赖
db.Transaction()自动携带插件，应在事务函数体内手动tx.Use(&Plugin{})
最易被忽略的一点：插件的回调注册顺序直接影响行为。比如你注册了一个 before_create 和一个 after_create，但中间有 GORM 内置的 gorm:before_create 被提前触发，而你的逻辑依赖某个字段已被设置——这时必须显式指定执行顺序，用 Before("gorm:before_create") 或 After("gorm:create")，而不是笼统的 Before("*")。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
