推荐使用 godror 驱动连接 GORM 操作 Oracle（非 gorm.io/driver/oracle），需配 Oracle Instant Client、注意 DSN 用 service_name、避免 undefined: VersionInfo 错误，正确配置连接池与时间类型映射。
gorm 官方不原生支持 Oracle，必须靠第三方驱动桥接。目前稳定可用的是 godror（推荐）或较旧的 github.com/cengsin/oracle，但后者已基本停更、兼容性差。用错驱动或版本组合，编译直接报 undefined: VersionInfo 这类错误。
用 godror 驱动连接 GORM（Go 1.21+ 推荐方案）
这是当前最主流、维护活跃、适配新 Go 版本的路径。注意：不是 gorm.io/driver/oracle（该包不存在），而是通过 godror 自带的 GORM 适配层。
- 安装依赖：
go get github.com/godror/godror（无需再装额外的oracle包） - DSN 格式严格为：
user/password@host:port/service_name，例如scott/tiger@localhost:1521/ORCLPDB1；不能用 SID（如ORCL），必须用 service_name（可通过lsnrctl status查） - 代码中调用方式是
gorm.Open(godror.Open(dsn), &gorm.Config{})，不是oracle.Open() - 若遇到
undefined: VersionInfo等编译错误，大概率是godror版本太新（v0.28+）而 Go 版本未达要求，降级到v0.27.3即可：go get github.com/godror/godror@v0.27.3
Oracle 客户端依赖（Linux/macOS 必配，Windows 可选）
godror 底层依赖 Oracle Instant Client 的 C 库。Linux/macOS 上不配置 LD_LIBRARY_PATH 或 DYLD_LIBRARY_PATH，运行时会 panic 报 failed to load oracle client library。
- 下载对应平台的
instantclient-basic（非 sdk），解压后记下路径，比如/opt/oracle/instantclient_21_12 - Linux：执行
export LD_LIBRARY_PATH=/opt/oracle/instantclient_21_12:$LD_LIBRARY_PATH，并写入~/.bashrc - macOS：用
DYLD_LIBRARY_PATH，且需关闭 SIP 或用sudo spctl --master-disable（仅开发机临时用） - Windows 用户可跳过——
godror会自动查找注册表或 PATH 中的oraocci*.dll
GORM 查询在 Oracle 上的常见坑
Oracle 对 SQL 语法和类型更严格，GORM 默认行为容易翻车：
-
First()和Last()在 Oracle 里可能失效，因为它们依赖ORDER BY ... LIMIT 1，而 Oracle 用ROWNUM；建议显式写Order("id DESC").Limit(1).First() - 主键字段名默认是
id，但 Oracle 表常用ID（大写）或PKEY；务必用 struct tag 显式指定：ID uint `gorm:"column:ID;primaryKey"` -
AutoMigrate不会自动建序列（sequence）或触发器（trigger）来实现自增，Oracle 需手动建SEQUENCE+BEFORE INSERT触发器，或改用IDENTITY列（Oracle 12c+） - 时间字段映射易出错：Oracle 的
DATE类型精度只到秒，TIMESTAMP才支持毫秒；GORM 默认映射为time.Time，但若 DB 字段是DATE，存纳秒会截断，建议 DB 侧统一用TIMESTAMP WITH TIME ZONE
连接池与并发写入性能关键点
Oracle 是重型数据库，但默认连接池太小会导致大量 goroutine block 在 acquireConn 上：
- 务必设置
sql.DB层连接池：db.SQLDB().SetMaxOpenConns(20)、SetMaxIdleConns(10)、SetConnMaxLifetime(30 * time.Minute) - 批量插入别用
CreateInBatches—— 它对 Oracle 是逐条INSERT，性能极差；应改用godror.BulkInsert或原生sql.Tx+Exec绑定数组参数 - 如果做十几万行导入，开 4–8 个 goroutine 并发写比单协程快得多，但超过 16 个反而因锁争用下降；实测阈值跟 Oracle 服务器配置强相关，得压测
Oracle 的 case-sensitive、sequence/trigger 机制、DATE/TIMESTAMP 差异这些底层特性，GORM 不会帮你兜底。连通只是第一步，真正落地时，DDL 配合、SQL 日志开关（logger.Info）、以及手写 raw query 的时机，往往比驱动选择更重要。
