Laravel任务切换至只读副本数据库后UniqueJobs锁释放失败问题求助

首先，我们来拆解一下你遇到的问题根源：
你的UniqueJobs trait使用数据库驱动的锁（从错误日志里的DatabaseLock可以确认），锁的记录存储在主库的cache表中。而你之前的代码中，调用DB::purge('mysql')会销毁主库的连接实例并关闭PDO连接——但这个连接实例已经被任务的锁对象持有引用了。当任务执行完毕后，Laravel尝试释放锁时，锁对象里的连接PDO已经是null，自然就抛出了Call to a member function prepare() on null的错误。

另外，你切换默认连接到只读副本的逻辑虽然能让任务查询走副本，但purge操作破坏了锁依赖的主库连接状态，这才是核心问题。

最优解决方案 #

下面提供两种可行的方案，你可以根据自己的场景选择：

方案一：切换默认连接但不Purge连接

这种方法避免销毁主库连接实例，只是临时修改默认连接的指向，任务结束后再恢复。这样锁依赖的主库连接始终保持可用。

修改你的任务handle方法：

public function handle() {
    // 保存当前默认连接名称
    $originalDefaultConn = DB::getDefaultConnection();
    
    try {
        // 切换默认连接到只读副本
        DB::setDefaultConnection('mysql_read_replica');
        
        // 👇 这里写你的任务处理代码，所有模型/助手函数都会自动使用只读副本
        // 比如：$userPosts = User::find($userId)->posts;
    } finally {
        // 无论任务成功/失败，都恢复原来的默认连接
        DB::setDefaultConnection($originalDefaultConn);
    }
}

为什么这个方案有效？

• 没有调用DB::purge，主库的连接实例始终存在于Laravel的连接管理器中，锁对象持有的连接引用不会失效。
• 临时切换默认连接后，所有模型查询、助手函数的数据库操作都会自动使用只读副本，完美解决了之前自定义属性/助手函数走主库的问题。

方案二：给锁单独指定主库连接

如果你担心切换默认连接可能影响其他隐性逻辑，可以直接配置缓存锁强制使用主库连接，任务中正常切换默认连接到副本即可。

1. 打开config/cache.php，找到database驱动的配置，添加connection参数指定主库连接：

'database' => [
    'driver' => 'database',
    'table' => 'cache',
    'connection' => 'mysql', // 明确锁使用主库连接
],

2. 然后任务中可以用你原来的切换逻辑，但去掉DB::purge调用：

public function handle() {
    $mysqlRrConfig = Config::get('database.connections.mysql_rr');
    $originalMysqlConfig = Config::get('database.connections.mysql');
    
    try {
        Config::set('database.connections.mysql', $mysqlRrConfig);
        // 任务处理代码
    } finally {
        Config::set('database.connections.mysql', $originalMysqlConfig);
    }
}

为什么这个方案有效？

• 锁的操作被强制绑定到主库连接，不受任务中默认连接切换的影响。
• 去掉DB::purge后，主库连接实例不会被销毁，锁释放时能正常执行写操作（删除锁记录）。

额外注意事项 #

• 确保你的只读副本确实是只读的，任务中不要包含任何写操作（比如更新、插入、删除），否则会触发只读实例的写错误。
• 如果任务中必须有少量写操作，建议在写操作时显式指定主库连接：DB::connection('mysql')->table('xxx')->update(...)。

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