Skip to content

fix(common): 修复共享基础组件并发竞态#707

Open
zhibeigg wants to merge 1 commit into
TabooLib:dev/6.3.0from
zhibeigg:fix/703-thread-safe-foundations
Open

fix(common): 修复共享基础组件并发竞态#707
zhibeigg wants to merge 1 commit into
TabooLib:dev/6.3.0from
zhibeigg:fix/703-thread-safe-foundations

Conversation

@zhibeigg

@zhibeigg zhibeigg commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

原有问题

多个全局共享基础组件使用了非原子的“读取—修改—写回”或无保护可变集合:

  • 内部事件总线在同一优先级并发注册监听器时可能互相覆盖。
  • ClassVisitorHandler 的访问器、延迟类集合和懒加载类集在并行扫描、注册与读取时缺少安全发布。
  • 命令执行与补全没有稳定复用同一命令树,执行结果状态也可能被并发或嵌套调用交叉覆盖。

典型触发场景与后果

  • 多插件并行启动并同时注册相同优先级事件:部分监听器静默丢失,事件行为取决于线程时序。
  • 类扫描、生命周期注入和延迟加载并行发生:可能出现 ConcurrentModificationException、漏扫类或读取到未完整初始化的集合。
  • 玩家同时执行命令、请求补全,或命令内部再次执行命令:参数、执行结果和补全树可能串线,产生随机错误结果。

本 PR 修改

  • 使用原子并发容器维护内部事件监听器,保证同优先级并发注册不会丢项。
  • ClassVisitorHandler 的共享集合增加线程安全访问和可靠发布,统一延迟初始化流程。
  • 让命令执行器和补全器复用同一棵命令树,并通过线程本地栈隔离并发与嵌套执行状态。
  • 增加事件总线、类集初始化、命令执行和嵌套调用并发回归测试。

修改目的

消除框架启动和运行阶段的时序依赖,使事件注册、类扫描和命令系统在并发环境下保持确定性,不再出现难以复现的监听器丢失或状态串扰。

兼容性与行为变化

  • 保持现有公开注册和命令 API。
  • 仅修正并发时的丢失更新、未安全发布和执行状态污染。

验证

  • ./gradlew :common-util:test :common-platform-api:test --rerun-tasks --no-parallel
  • ./gradlew :common-util:build :common-platform-api:build --rerun-tasks --no-parallel
  • git diff --check

Refs #703

保证事件监听、类访问器缓存与延迟集合并发安全,并让命令树只构建一次且隔离每次执行结果。
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant