Go客户端连接EdgeDB运行后出现超时挂起问题求助

问题背景 #

部署在AWS的Go服务包含两个端点：

• 心跳端点：不连接EdgeDB，始终正常运行
• 列表查询端点：执行select Foo { ... };语句查询数据库对象
  服务启动初期一切正常，但运行约1天后，列表端点会出现永久挂起的情况（推测为客户端连接数据库超时），本地测试环境也会复现该问题，且无错误日志输出。

创建客户端的代码如下：

log.Println("Connecting to EdgeDB...")
ctx := context.Background()
var opts edgedb.Options
opts = edgedb.Options{
        Database:    os.Getenv("DB_DBNAME"),
        User:        os.Getenv("DB_USER"),
        Password:    edgedb.NewOptionalStr(os.Getenv("DB_PASSWORD")),
        Host:        os.Getenv("DB_HOST"),
        Port:        5656,
        Concurrency: uint(4),
        TLSOptions: edgedb.TLSOptions{
                SecurityMode: "insecure",
        },
}
db, dbErr := edgedb.CreateClient(ctx, opts)

return projectDb{DB: db}, db, dbErr

关键配置缺失与修复方案 #

你的客户端配置缺少了连接池生命周期管理和查询上下文超时的关键设置，这是导致连接失效后服务挂起的核心原因：

1. 添加连接池超时配置 #

AWS网络环境中，长时间空闲的连接会被NAT网关或防火墙主动断开，若客户端未配置连接回收机制，会复用已失效的连接导致挂起。需在edgedb.Options中添加以下参数：

opts = edgedb.Options{
        // 原有配置...
        ConnectTimeout: 10 * time.Second, // 建立新连接的超时时间
        IdleTimeout:    30 * time.Minute, // 空闲连接超过该时间自动回收
        MaxLifetime:    1 * time.Hour,    // 连接的最大存活周期，避免长期存活的连接失效
}

2. 查询时使用带超时的上下文 #

当前查询如果使用context.Background()（无超时限制），遇到连接失效时会无限等待，导致端点挂起。所有数据库查询必须使用带超时的上下文：

// 在HTTP请求处理函数中
func listHandler(w http.ResponseWriter, r *http.Request) {
    // 创建5秒超时的上下文
    ctx, cancel := context.WithTimeout(r.Context(), 5*time.Second)
    defer cancel()

    var foos []Foo
    err := db.Query(ctx, &foos, "select Foo { ... };")
    if err != nil {
        // 处理错误，返回响应
        http.Error(w, err.Error(), http.StatusInternalServerError)
        return
    }
    // 返回查询结果
}

3. 匹配连接池并发数与服务负载 #

Concurrency: uint(4)设置了连接池的最大并发连接数，需确保该值与服务的实际并发请求数匹配：

• 若服务并发请求数远大于4，会导致请求排队等待连接，最终引发超时
• 可根据压测结果调整该值，例如设置为服务QPS的1/3~1/2

4. 启用客户端日志排查问题 #

添加日志配置，便于追踪连接创建、回收及错误信息：

opts.Logger = func(ctx context.Context, level edgedb.LogLevel, msg string, args ...interface{}) {
    log.Printf("[%s] %s", level, fmt.Sprintf(msg, args...))
}

原理说明 #

• 空闲连接回收：避免复用被AWS网络断开的无效连接
• 查询超时：防止单个查询因连接问题无限阻塞，快速返回错误并释放资源
• 连接生命周期限制：强制替换长期存活的连接，规避数据库端的连接超时策略

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