Laravel通过Redis的SET命令结合NX和PX选项实现原子性加锁，使用唯一token标识进程，并借助Lua脚本安全释放锁，确保分布式环境下任务不重复执行。

Laravel 使用 Redis 实现分布式锁，核心是利用 Redis 的原子操作特性来保证同一时间只有一个进程能获取到锁。这在多服务器、队列任务或定时命令并发执行的场景中非常有用，避免重复处理造成数据异常。

1. 安装并配置 Redis 扩展

Laravel 默认支持 Redis，但需要确保已安装 predis/predis 或启用 PHP 的 Redis 扩展。

然后在 config/database.php 中确认 Redis 配置正确：

'redis' => [
    'client' => 'predis',
    'default' => [
        'host' => env('REDIS_HOST', '127.0.0.1'),
        'password' => env('REDIS_PASSWORD', null),
        'port' => env('REDIS_PORT', 6379),
        'database' => 0,
    ],
],

2. 使用 Redis::set 实现原子加锁

Redis 的 SET 命令支持 NX（不存在时设置）和 PX（毫秒过期），可以原子性地实现加锁。

示例代码：

$lockKey = 'lock:send_report';
$ttl = 10000; // 锁过期时间，单位毫秒
$token = uniqid(); // 唯一标识当前进程

$locked = Redis::set($lockKey, $token, 'NX', 'PX', $ttl);

if (! $locked) {
    // 获取锁失败，说明其他进程正在执行
    return response('任务已在执行中', 423);
}

// 成功获取锁，开始执行任务
try {
    // 你的业务逻辑，比如发送报表
    dispatch(new SendReportJob());
} finally {
    // 使用 Lua 脚本安全释放锁（防止删除别人的锁）
    $script = <<<'LUA'
if redis.call("get", KEYS[1]) == ARGV[1] then
    return redis.call("del", KEYS[1])
else
    return 0
end
LUA;
    Redis::eval($script, 1, $lockKey, $token);
}

3. 封装为可复用的锁服务

为了方便使用，可以封装一个简单的分布式锁类：

class DistributedLock
{
    protected $key;
    protected $token;
    protected $ttl;

    public function __construct($key, $ttl = 10000)
    {
        $this->key = "lock:{$key}";
        $this->ttl = $ttl;
        $this->token = uniqid();
    }

    public function acquire()
    {
        return Redis::set($this->key, $this->token, 'NX', 'PX', $this->ttl);
    }

    public function release()
    {
        $script = <<<'LUA'
if redis.call("get", KEYS[1]) == ARGV[1] then
    return redis.call("del", KEYS[1])
else
    return 0
end
LUA;
        Redis::eval($script, 1, $this->key, $this->token);
    }
}

使用方式：

$lock = new DistributedLock('import_data', 5000);
if (! $lock->acquire()) {
    return '资源被占用';
}

try {
    // 执行关键操作
} finally {
    $lock->release();
}

4. 注意事项与最佳实践

使用 Redis 分布式锁时要注意以下几点：

• 设置合理的过期时间：避免死锁，但也不能太短导致任务未完成锁就释放
• 使用唯一 token 标识锁持有者：防止误删其他进程的锁
• 必须用 Lua 脚本释放锁：保证“判断+删除”的原子性
• 考虑 Redis 单点问题：生产环境建议使用 Redis Sentinel 或 Cluster 提高可用性