GORM带参数执行SQL每调用5次必挂起，无参数可正常运行如何解决？

根因分析 #

你遇到的固定5次调用后挂起的问题，本质是数据库连接池耗尽：

• 带占位符的查询（包括?占位符、命名参数）会触发GORM的预编译逻辑，若预编译语句或者查询结果集未正确释放，会持续占用数据库连接
• 大部分数据库驱动/ORM的默认最大空闲/打开连接数接近5，5次调用后所有连接被占满，第6次请求无法获取连接就会永久阻塞
• 直接硬拼接参数的SQL不需要预编译，执行完成后连接会被立即释放回池，所以不会出现阻塞问题

排查修复步骤 #

• 第一步：补充错误捕获，确认是否有底层报错被忽略
  你当前代码未处理GORM返回的错误，首先补全错误判断：

result := db.Raw(`select count(*) as hash from transaction_logs left join blocks on transaction_logs.block_number = blocks.number
where (transaction_logs.address = ? and transaction_logs.topic0 = ?) and blocks.total_confirmations >= 7 
group by transaction_hash`, 
    strings.ToLower("0xa11265a58d9f5a2991fe8476a9afea07031ac5bf"),
    "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef").Scan(&totalIds)
if result.Error != nil {
    // 自行处理错误日志
    println("查询失败: ", result.Error.Error())
}

注意：你的变量名tx容易产生歧义，此处用result指代，若你确实开启了事务未提交/回滚，也会导致连接不释放，请检查事务逻辑

• 第二步：手动关闭结果集，避免连接泄漏
  你的SQL用了group by transaction_hash会返回多条结果，直接用Scan赋值给单个变量时，GORM底层的结果集rows可能不会被自动关闭，建议显式迭代并关闭：

rows, err := db.Raw(`select count(*) as hash from transaction_logs left join blocks on transaction_logs.block_number = blocks.number
where (transaction_logs.address = ? and transaction_logs.topic0 = ?) and blocks.total_confirmations >= 7 
group by transaction_hash`, 
    strings.ToLower("0xa11265a58d9f5a2991fe8476a9afea07031ac5bf"),
    "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef").Rows()
if err != nil {
    // 处理错误
    return
}
defer rows.Close() // 必须加defer关闭rows，释放连接
totalIds := make([]int, 0)
for rows.Next() {
    var cnt int
    if err := rows.Scan(&cnt); err != nil {
        // 处理错误
        return
    }
    totalIds = append(totalIds, cnt)
}

• 第三步：关闭预编译缓存，避免长期占用连接
  如果你全局开启了GORM的PrepareStmt预编译缓存，可以在当前会话临时关闭，避免预编译语句长期占用连接：

result := db.Session(&gorm.Session{PrepareStmt: false}).Raw("你的SQL", 参数...).Scan(&totalIds)

• 第四步：调整连接池配置，避免连接耗尽
  初始化GORM后主动调整数据库连接池参数，适配你的业务并发量：

sqlDB, err := db.DB()
if err != nil {
    panic(err)
}
// 最大打开连接数，根据业务并发调整，建议不低于10
sqlDB.SetMaxOpenConns(50)
// 最大空闲连接数，建议设为最大打开连接数的1/2~1/3
sqlDB.SetMaxIdleConns(20)
// 连接最大存活时间，避免拿到无效连接
sqlDB.SetConnMaxLifetime(time.Hour)

内容的提问来源于stack exchange，提问作者shiva kumar