JavaFX中AnchorPane随机出现重复子节点异常，求排查建议

针对你遇到的随机触发的异常：

java.lang.IllegalArgumentException: Children: duplicate children added: parent = AnchorPane

以下是具体的排查方向：

• 确认UI操作的线程安全性
  JavaFX要求所有UI组件的修改必须在JavaFX应用线程中执行。如果增删操作是在后台线程（比如异步任务、定时器回调）中调用的，就可能引发并发修改，导致随机异常。
  确保所有对anchorPane.getChildren()的操作都通过Platform.runLater()包裹，或确认调用代码本身处于UI线程（比如按钮点击事件处理器内）：

  Platform.runLater(() -> {
      anchorPane.getChildren().add(myNode);
      // 或执行 remove 操作
  });
  

• 排查equals/hashCode重写的潜在问题
  你重写了MyNode的equals和hashCode，仅通过myNodeId判断对象相等，但JavaFX的ObservableList执行remove时会依赖equals匹配元素。如果存在多个myNodeId相同的MyNode实例，调用remove(myNode)可能误删其他节点，导致目标节点未被正确移除，后续再次添加就会触发重复异常。
  可以暂时注释掉equals和hashCode的重写，测试异常是否消失；同时检查业务逻辑中是否允许出现myNodeId重复的节点。

• 检查是否存在重复添加的逻辑分支
  虽然你只展示了单次add/remove，但实际代码中可能存在重复触发添加的场景（比如事件多次绑定、异步回调重复执行）。可以在添加前增加判断，避免重复添加：

  if (!anchorPane.getChildren().contains(myNode)) {
      anchorPane.getChildren().add(myNode);
  }
  

  同时排查代码中所有可能调用add(myNode)的位置，确认没有重复触发的情况。

• 排查节点复用导致的父容器冲突
  如果MyNode实例被复用（比如从缓存中取出、在多个容器间转移），但之前没有完全从原父容器中移除，再次添加到AnchorPane时就会触发异常。可以在添加前做强制移除处理：

  if (myNode.getParent() != null) {
      ((Pane) myNode.getParent()).getChildren().remove(myNode);
  }
  anchorPane.getChildren().add(myNode);
  

  或者确保每次添加的MyNode都是全新实例，不被其他容器持有。

• 增强调试定位问题

  • 在add和remove操作前后打印日志，记录节点的原生哈希值（System.identityHashCode(myNode)，避免自定义hashCode干扰）、myNodeId以及AnchorPane的子节点数量：

    System.out.printf("Adding node: id=%d, identityHash=%d, current children count=%d%n", 
                      myNode.getMyNodeId(), 
                      System.identityHashCode(myNode), 
                      anchorPane.getChildren().size());
    anchorPane.getChildren().add(myNode);
    

  • 给IllegalArgumentException添加断点，当异常抛出时，查看调用栈确认触发add操作的代码位置，以及此时myNode的父容器信息（myNode.getParent()）。

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