gorm 本身不内置 oracle 支持，必须通过第三方 dialector 驱动桥接；当前最可行的两条路径是 godror（功能全但依赖 cgo 和 oracle client）和 go-ora + gorm-oracle（纯 go、跨平台友好，但部分 oracle 特性支持有限）。
直接说结论：GORM 本身不内置 Oracle 支持，必须通过第三方 Dialector 驱动桥接；当前最可行的两条路径是 godror（功能全但依赖 Cgo 和 Oracle Client）和 go-ora + gorm-oracle（纯 Go、跨平台友好，但部分 Oracle 特性支持有限）。选哪条，取决于你是否能接受编译约束和运行时依赖。
用 godror 驱动连接 Oracle：为什么总卡在编译或环境变量？
godror 是目前功能最完整、社区维护最活跃的 Go Oracle 驱动，但它底层调用 Oracle Call Interface（OCI），因此强制要求：
- 安装 Oracle Instant Client（Linux/macOS 需设
LD_LIBRARY_PATH，Windows 需把oci.dll所在目录加进PATH） - 启用
cgo（即不能用CGO_ENABLED=0编译） - 系统有 GCC 或兼容 C 编译器（Windows 上常见报错
cgo: C compiler "gcc" not found）
典型 DSN 格式为：user/password@host:port/service_name，例如：scott/tiger@localhost:1521/ORCLPDB1。若服务名写成 SID（如 ORCL），连接会静默失败——Oracle 12c+ 默认用 service_name，不是 SID。
用 gorm-oracle（基于 go-ora）替代 godror：哪些地方会“掉功能”？
gorm-oracle 是纯 Go 实现的 GORM 适配层，封装了 go-ora 驱动，优势是免 Client、免 Cgo、可交叉编译。但它不支持：
-
LOB类型字段的原生读写（CLOB/BLOB只能当string或[]byte处理，长度超 32KB 易截断） - Oracle 的高级特性：
REF CURSOR、OBJECT TYPE、TABLE TYPE、DBMS_OUTPUT等 -
db.Exec()返回的sql.Result.RowsAffected()在某些语句下始终为 -1（因协议限制）
初始化方式类似：gorm.Open(oracle.Open(dsn), &gorm.Config{})，其中 oracle 来自 github.com/seelly/gorm-oracle，不是 gorm.io/driver/oracle（后者不存在）。
Oracle 字段映射与 GORM tag 常见坑
Oracle 表名、列名默认大写且区分大小写，而 GORM 默认生成小写 SQL。不显式指定，容易查不到数据：
- 用
TableName()方法强制表名：func (User) TableName() string { return "T_USER" } - 用
gorm:"column:USER_NAME"显式绑定列名，否则 GORM 会按user_name去查，而 Oracle 实际是USER_NAME或username -
ID主键若为NUMBER类型，别用int接收——Oracle 的NUMBER可能超出 int64 范围；稳妥做法是用int64或*big.Int，并加gorm:"primaryKey"
另外，First() 在 Oracle 中行为异常：它生成的 SQL 含 ROWNUM ，但没加 <code>ORDER BY 时结果不可控；务必配合 Order("id ASC") 使用，否则可能随机返回某一行。
连接池与超时配置不能只靠 GORM.Config
GORM 的 &gorm.Config{} 不控制底层连接池，必须透传 *sql.DB 设置：
- 获取原生
*sql.DB：db.SQL()（注意不是db.DB()，后者是 GORM 封装对象） - 设置空闲连接数：
db.SQL().SetMaxIdleConns(10) - 设置最大打开连接数：
db.SQL().SetMaxOpenConns(30) - 设置连接存活时间（防 Oracle 的
ORA-03135）：db.SQL().SetConnMaxLifetime(30 * time.Minute)
Oracle 默认连接空闲 30 分钟断开，若 ConnMaxLifetime 设得比这还长，连接复用时就会报 ORA-03135: connection lost contact ——这个错误常被误判为网络问题，其实是连接池没及时清理过期连接。
