SurrealDB批量更新TiKV存储数据时遇Failed to resolve lock错误

问题场景 #

• 运行SurrealDB的Docker命令：

  docker run --rm  -p 8000:8000 docker.io/surrealdb/surrealdb:latest start --log trace --user root --pass root tikv://10.206.0.9:2379
  

• 单条更新操作成功，例如执行：

  UPDATE account SET username.first = "Tobie",username.last = "Morgan Hitchcock"  where id="account:02vpvzway97jn2wj23kq"
  

  返回结果：

  [
      {
          "time": "222.085746ms",
          "status": "OK",
          "result": [
              {
                  "age": 18,
                  "datatime": "2022-10-05T03:20:57.781059411Z",
                  "id": "account:02vpvzway97jn2wj23kq",
                  "name": "SurrealDB99",
                  "password": "b50339a10e1de285ac99d4c3990b8693",
                  "username": {
                      "first": "Tobie",
                      "last": "Morgan Hitchcock"
                  }
              }
          ]
      }
  ]
  

• 批量更新操作失败，例如执行：

  UPDATE account SET password=crypto::md5(id) RETURN NONE;
  

  返回错误：

  [
      {
          "time": "1.035028887s",
          "status": "ERR",
          "detail": "There was a problem with a datastore transaction: Failed to resolve lock"
      }
  ]
  

解决步骤 #

• 拆分批量更新为小批次：TiKV锁机制在处理大规模更新时易触发锁冲突，将全量更新拆分为多个小批次，按ID范围分段执行，比如：

  UPDATE account SET password=crypto::md5(id) WHERE id > "account:0" AND id < "account:1000" RETURN NONE;
  UPDATE account SET password=crypto::md5(id) WHERE id > "account:1000" AND id < "account:2000" RETURN NONE;
  

  每个批次控制100-500行，根据数据量调整，缩小锁竞争范围。

• 调整TiKV锁超时参数：若有权限修改TiKV配置，可增大lock_wait_timeout（默认20秒），让事务有更长时间等待锁释放；同时调整resolve_lock_timeout优化锁解析逻辑，修改后重启TiKV节点生效。

• 验证版本兼容性：确保SurrealDB与TiKV集群版本兼容，旧版本SurrealDB可能存在事务锁处理bug，尝试升级SurrealDB到最新稳定版后重新测试。

• 优化批量更新逻辑：避免在批量语句中使用依赖当前行的函数（如crypto::md5(id)），先批量导出ID并计算对应MD5值，再通过小批量更新执行，缩短锁持有时间窗口。

• 检查TiKV集群状态：确认TiKV节点运行正常，无负载过高、网络延迟过大情况，通过监控面板查看锁冲突、事务超时指标，排查是否因集群资源不足导致问题。

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