Go使用ArangoDB驱动如何设置更长HTTP超时解决504网关超时问题

问题根因 #

你遇到的504 Gateway Timeout错误由ArangoDB前端的Nginx反向代理抛出，并非Go客户端context超时或ArangoDB服务端查询超时导致。你当前设置的context超时仅作用于Go客户端与ArangoDB的请求上下文，不会修改Nginx的代理超时规则，因此请求在到达140秒前就被Nginx主动断开，返回了HTML格式的错误页，才会触发Unsupported content type 'text/html'的报错。

解决方案 #

1. 调整Nginx反向代理超时配置 #

在Nginx对应ArangoDB代理的location配置块中添加以下参数，将代理超时调整为大于你查询最大耗时的值（示例为300秒）：

location / {
    proxy_pass http://你的ArangoDB服务地址;
    # 调整代理各阶段超时
    proxy_connect_timeout 300s;
    proxy_send_timeout 300s;
    proxy_read_timeout 300s;
    # 其余原有配置保持不变
}

修改配置后执行nginx -s reload生效。
如果你的架构中还存在云负载均衡、API网关等其他中间转发层，也需要同步调整对应组件的超时阈值。

2. 确认ArangoDB服务端查询超时配置 #

检查ArangoDB配置文件中的--query.max-runtime参数，确保其值大于你的查询实际耗时（示例140秒），避免服务端主动终止长查询。

3. 修正Go端context的使用逻辑 #

你当前将带长超时的context传给了Database()方法，该context仅作用于「获取数据库实例」这一短请求，真正执行查询时需要将带长超时的context传入查询执行方法，示例如下：

// 获取数据库实例用短超时即可
ctx := driver.WithQueryCount(context.Background())
dbCtx, dbCancel := context.WithTimeout(ctx, 10*time.Second)
defer dbCancel()
db, err := c.Database(dbCtx, internalDatabase)
if err != nil {
    // 错误处理逻辑
}

// 执行长查询时单独传入长超时context
queryCtx, queryCancel := context.WithTimeout(context.Background(), 5*time.Minute)
defer queryCancel()
// 替换为你的实际AQL查询和参数
cursor, err := db.Query(queryCtx, "YOUR_LONG_RUNNING_AQL", nil)
if err != nil {
    // 错误处理逻辑
}
defer cursor.Close()

4. 可选：查询性能优化 #

如果查询耗时长期超过2分钟，建议优先做查询优化：给查询涉及的字段加合适的索引、拆分大查询为多批次小范围查询、使用ArangoDB游标分页拉取结果，避免单次请求超时风险。

内容的提问来源于stack exchange，提问作者Joes de Jonge