
本文详解bukkit插件开发中因arraylist非静态、非线程安全导致事件监听失效的问题,并提供基于copyonwritearraylist的可靠解决方案。
本文详解bukkit插件开发中因arraylist非静态、非线程安全导致事件监听失效的问题,并提供基于copyonwritearraylist的可靠解决方案。
在Bukkit/Spigot插件开发中,若需跨事件(如命令执行与玩家重生)共享玩家状态(例如“已启用夜视效果”),必须确保该状态数据具有全局可见性和线程安全性。您当前代码中的 private ArrayList<player> gammaList</player> 是实例变量(非 static),这意味着每次插件加载或类被初始化时都会创建独立副本;而 Bukkit 的 CommandExecutor 和 Listener 实例通常由服务器在不同上下文中多次创建或复用,导致 onCommand 中添加的玩家无法被 onPlayerDie(实际应为 PlayerRespawnEvent,后文说明)中的 gammaList 正确识别——根本原因在于两个事件处理方法操作的是不同对象的 ArrayList 实例。
✅ 正确做法:使用静态 + 线程安全集合
将列表声明为 static 并替换为 CopyOnWriteArrayList(专为高读低写并发场景设计,适合 Bukkit 多线程环境):
private static final List<Player> gammaList = new CopyOnWriteArrayList<>();
同时注意:EntityResurrectEvent 并非标准 Bukkit 事件(Spigot 1.19+ 已废弃),正确监听玩家重生应使用 PlayerRespawnEvent。此外,为避免内存泄漏,建议在玩家离线时及时清理列表:
@EventHandler
public void onPlayerQuit(PlayerQuitEvent event) {
gammaList.remove(event.getPlayer());
}
@EventHandler
public void onPlayerRespawn(PlayerRespawnEvent event) {
Player player = event.getPlayer();
if (gammaList.contains(player)) {
player.addPotionEffect(new PotionEffect(PotionEffectType.NIGHT_VISION, Integer.MAX_VALUE, 1, false, false));
}
}⚠️ 关键注意事项:
-
永远勿用
==或contains()直接比较Player对象:CopyOnWriteArrayList依赖Player#equals(),而 Bukkit 的Player实现已正确重写,可安全使用。 -
避免
Integer.MAX_VALUE导致性能隐患:建议设为较大值(如20 * 60 * 20≈ 20分钟),并配合定时任务刷新效果。 -
注册监听器前确保单例初始化:在主类
onEnable()中调用getServer().getPluginManager().registerEvents(this, this)即可,无需额外单例模式。
通过以上调整,gammaList 将成为插件范围内唯一、线程安全的共享状态容器,命令启用/禁用与重生自动续效功能即可稳定运行。

















