Flame升级后碰撞回调异常：两球均被移除问题排查

问题根源 #

你遇到的核心问题是Flame新版中beginContact是双向触发的：当两个Ball组件碰撞时，两个组件各自的beginContact方法都会被调用。你的原逻辑会在两次触发中分别给对方标记shouldRemoved = true，最终导致两个球都被标记为移除。

从你打印的日志也能看出来：

flutter: ballA shouldRemoved: false levelup: true |||| ballB true levelup: false
flutter: ballA shouldRemoved: true levelup: true |||| ballB true levelup: true

第一次是其中一个球的回调执行，第二次是另一个球的回调执行，两次叠加后两个球的shouldRemoved都变成了true。

而旧版的ContactCallback<Ball, Ball>是全局回调，只会触发一次，所以不会有重复处理的问题。

解决方案 #

要解决这个问题，需要确保碰撞逻辑只被执行一次，同时还要满足“掉落的球碰到已落地的球”这个前提条件（避免空中球碰撞也触发逻辑）。

实现思路 #

1. 利用对象的唯一标识（直接用hashCode即可，同一生命周期内唯一），只让其中一个球执行碰撞处理逻辑；
2. 增加落地状态判断，确保只有“未落地的掉落球”碰到“已落地的球”时才触发逻辑。

修改后的代码示例 #

假设你已经给Ball类添加了isGrounded属性标记是否落地：

@override
void beginContact(Object other, Contact contact) {
  if (other is Ball) {
    // 只让hashCode更小的球执行逻辑，避免双向触发重复处理
    if (hashCode >= other.hashCode) return;

    // 区分掉落球和已落地的球
    if (!isGrounded && other.isGrounded) {
      // 当前球是掉落状态，移除当前球，对方升级
      shouldRemoved = true;
      other.levelUp = true;
    } else if (isGrounded && !other.isGrounded) {
      // 当前球已落地，移除对方球，当前球升级
      other.shouldRemoved = true;
      levelUp = true;
    }

    print('处理后：当前球 shouldRemoved: $shouldRemoved levelup: $levelUp | 对方球 shouldRemoved: ${other.shouldRemoved} levelup: ${other.levelUp}');
  }
}

关键说明 #

• 使用hashCode区分：因为每个对象的hashCode在内存中是唯一的，通过比较大小可以确保只有其中一个球执行逻辑，避免重复触发；
• 落地状态判断：确保只有符合业务场景的碰撞才会触发移除/升级逻辑，避免空中两个球碰撞误触发。

如果你的Ball类没有isGrounded属性，可以通过判断球的速度来实现，比如：

// 用y方向速度判断是否落地（速度接近0表示已落地）
bool get isGrounded => body.velocity.y.abs() < 0.1;

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