org.apache.zookeeper.KeeperException.NodeExistsException报错的解决方法，亲测有效

问题分析

org.apache.zookeeper.KeeperException.NodeExistsException 异常表示在尝试创建一个已经存在的 ZooKeeper 节点（ZNode）时触发的。在 ZooKeeper 中，每个 ZNode 都有一个唯一的路径，并且不允许创建具有相同路径的多个 ZNode。

报错原因

当您尝试使用 ZooKeeper 客户端的 create 方法来创建一个已经存在的 ZNode 时，ZooKeeper 服务器会返回一个 NodeExistsException 异常。这通常发生在以下几种情况：

1. 应用程序逻辑错误，导致多次尝试创建同一个 ZNode。
2. 并发环境中，多个客户端同时尝试创建相同的 ZNode。
3. 客户端没有正确处理之前的创建请求，并错误地认为 ZNode 不存在。

解决思路

1. 检查 ZNode 是否存在：在尝试创建 ZNode 之前，使用 exists 方法检查该 ZNode 是否已经存在。
2. 处理并发创建：如果多个客户端可能同时尝试创建相同的 ZNode，则可以使用 ZooKeeper 的顺序节点（Sequential ZNode）特性或实现一个分布式锁来确保只有一个客户端能够成功创建。
3. 重试机制：实现一个重试机制，当遇到 NodeExistsException 时，可以等待一段时间后重试或采取其他逻辑。

解决方法

方法一：检查 ZNode 是否存在

在尝试创建 ZNode 之前，首先使用 exists 方法来检查该 ZNode 是否已经存在。

import org.apache.zookeeper.*;

public class ZKCreateExample {
    private static final String CONNECT_STRING = "localhost:2181";
    private static final int SESSION_TIMEOUT = 5000;

    public static void main(String[] args) throws Exception {
        ZooKeeper zk = new ZooKeeper(CONNECT_STRING, SESSION_TIMEOUT, watchedEvent -> {});

        String path = "/path/to/znode";
        Stat exists = zk.exists(path, false);
        if (exists == null) {
            // ZNode 不存在，可以安全地创建
            byte[] data = "my data".getBytes();
            zk.create(path, data, ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT);
        } else {
            // ZNode 已经存在，可以选择更新数据或执行其他逻辑
            System.out.println("ZNode already exists: " + path);
        }

        zk.close();
    }
}

方法二：使用顺序节点

下滑查看解决方法

如果多个客户端可能同时尝试创建相同的 ZNode，则可以使用顺序节点来确保每个客户端都能成功创建唯一的 ZNode。

import org.apache.zookeeper.*;

public class ZKSequentialCreateExample {
    private static final String CONNECT_STRING = "localhost:2181";
    private static final int SESSION_TIMEOUT = 5000;

    public static void main(String[] args) throws Exception {
        ZooKeeper zk = new ZooKeeper(CONNECT_STRING, SESSION_TIMEOUT, watchedEvent -> {});

        String path = "/path/to/sequential-"; // 注意末尾的短横线
        byte[] data = "my data".getBytes();
        String createdPath = zk.create(path, data, ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT_SEQUENTIAL);

        // createdPath 将是类似于 "/path/to/sequential-0000000001" 的唯一路径
        System.out.println("Created ZNode with path: " + createdPath);

        zk.close();
    }
}

方法三：实现重试机制

在创建 ZNode 的代码中实现一个重试机制，当遇到 NodeExistsException 时进行重试。

import org.apache.zookeeper.*;

public class ZKCreateWithRetryExample {
    private static final String CONNECT_STRING = "localhost:2181";
    private static final int SESSION_TIMEOUT = 5000;
    private static final int MAX_RETRIES = 3;

    public static void main(String[] args) throws Exception {
        ZooKeeper zk = new ZooKeeper(CONNECT_STRING, SESSION_TIMEOUT, watchedEvent -> {});

        String path = "/path/to/znode";
        byte[] data = "my data".getBytes();

        for (int i = 0; i < MAX_RETRIES; i++) {
            try {
                zk.create(path, data, ZooDefs.Ids.OPEN_ACL_UNSAFE, CreateMode.PERSISTENT);
              break;
            } catch (KeeperException.NodeExistsException e) {
                if (i == MAX_RETRIES - 1) {
                    // 如果达到了最大重试次数，则抛出异常或进行其他处理
                    throw new Exception("Failed to create ZNode after " + MAX_RETRIES + " retries", e);
                } else {
                    // 否则等待一段时间再重试
                    Thread.sleep(1000); // 例如，等待1秒后再重试
                }
            }
        }

        zk.close();
    }
}

总结

在处理 org.apache.zookeeper.KeeperException.NodeExistsException 异常时，您可以根据具体的应用场景选择适合的解决方法。如果只需要确保 ZNode 存在，那么检查 ZNode 是否存在并相应处理即可。如果需要多个客户端都能成功创建 ZNode，则可以使用顺序节点或分布式锁。如果创建 ZNode 的操作可能由于并发或其他原因失败，那么实现一个重试机制可以确保操作的最终成功。在编写代码时，请确保正确处理异常，并考虑并发和重试对系统性能和稳定性的影响。