Redlock获取锁失败：超出资源锁尝试次数（Node.js/TypeScript）

问题描述 #

我在使用Redlock获取指定资源锁时持续失败，报错信息：
Error acquiring lock: LockError: Exceeded X attempts to lock the resource "xxx".

已查看GitHub相关议题#168，其中解决方案均无效；尝试降级ioredis和redlock版本也未解决问题。

环境信息 #

• Node.js版本：18.16.0
• Redlock版本：4.2.0
• ioredis版本：5.3.2

代码片段 #

import Redlock from "redlock";
import { RedlockPort } from "../../../use-case/port/redlock_port.js";
import { Redis } from "ioredis";

export class RedlockAdapter implements RedlockPort {
  private redlock: Redlock;

  constructor(client: Redis) {
    this.redlock = new Redlock([client], { retryCount: 10, retryDelay: 1000 });
   }

  async acquireLock(resource: string) {
    try {
      const lock = await this.redlock.acquire([resource], 1000)
      return lock;
    } catch (e) {
      console.error('Error acquiring lock:', e);
      throw e;
    }
  }

  async releaseLock(lock: Redlock.Lock): Promise<void> {
    await lock.release();
  }
}

已尝试方案 #

• 降级ioredis和redlock至旧版本
• 确认Redis客户端连接正常
• 调整Redlock的retryCount、retryDelay等配置参数

求可行的解决方法或排查方向。

解决方案与排查方向 #

1. 检查资源锁的持有状态 #

直接通过Redis命令查看目标资源的锁情况：

# 查看锁的剩余存活时间
TTL "redlock:xxx"
# 查看锁的具体内容
GET "redlock:xxx"

如果锁长期存在且未释放，可能是其他进程未正确释放锁或进程崩溃导致锁残留，可手动删除锁测试：

DEL "redlock:xxx"

2. 确保Redis客户端实例为单例 #

如果每次创建RedlockAdapter都新建Redis连接，会导致Redlock无法正确协调锁状态。检查Redis客户端初始化逻辑，保证全局仅一个Redis实例传入Redlock。

3. 优化锁超时与重试策略 #

当前配置中锁超时仅1000ms，重试间隔1000ms，若资源竞争激烈，容易导致重试失败：

• 延长锁超时时间（如3000ms），给锁持有者足够时间处理业务并释放锁
• 缩短重试间隔（如200ms）、增加重试次数（如20次），同时加入随机抖动避免冲突
  修改示例：

// 构造函数调整重试配置
this.redlock = new Redlock([client], { 
  retryCount: 20, 
  retryDelay: 200,
  retryJitter: 50 // 添加随机抖动，避免多进程同时重试引发竞争
});

// acquire时延长锁超时
const lock = await this.redlock.acquire([resource], 3000)

4. 校验Redis服务器时间同步 #

Redlock依赖Redis服务器时间的准确性，若服务器时间偏移过大，会导致锁TTL计算错误。执行命令检查Redis时间：

TIME

确保Redis服务器与应用服务器时间同步，误差控制在100ms以内。

5. 监听Redlock事件获取失败细节 #

通过Redlock的事件监听捕获锁竞争的具体原因：

this.redlock.on('failedLockAttempt', (error) => {
  console.log('锁尝试失败详情:', error);
});

日志会展示每次失败的具体原因，比如锁被持有、Redis操作超时等。

6. 排查锁重入问题 #

Redlock默认不支持锁重入，若同一进程多次尝试获取同一锁会失败。可在获取锁前检查当前进程是否已持有该锁，或改用支持重入的锁实现。

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