CRASH: 快捷键不判空 createRecipeGui 可致客户端 NPE #5

Open
opened 2026-11-16 22:15:04 +00:00 by layue13 · 0 comments
Owner

调研编号:I-MI-KEYBIND-CREATERECIPGUI-NULL

现象

Mobs-Info 客户端快捷键 Open Mobs Info GUI 调用 NEI GuiCraftingRecipe.createRecipeGui(overlayId, false) 后不判空,直接 gui.currenthandlers.add(...)。

NEI 在 handlers.isEmpty() 时返回 null(RecipeHandlerQuery 会丢掉 numRecipes()==0 的 handler)。客户端 MobHandler.cachedRecipes 只在收到服务端 LoadConfigPacket 后由 processMobRecipeMap(mobs, overrides) 填充;主菜单/进服前、包未到、或服务端 mobHandlerEnabled=false(包内清表)时集合为空 → createRecipeGui 返回 null → 按键即客户端 NPE。

危害类与优先级

  • 危害类:CRASH
  • 优先级:p2
  • 标签:type/defect、priority/p2、area/compatibility、origin/scan
  • 后果层级:客户端崩;默认键为 KEY_NONE(需玩家绑定后才触发),但绑定后在「配方尚未同步 / Mob Handler 关闭」路径上可稳定复现

证据(生效源码)

  • 载体:TDLM/Mobs-Info pin 3ea6265 × TDLM/NotEnoughItems pin 5dbc021
  • 位置:
    • Mobs-Info/work/.../KeyBindingHandler.java:33-41
    • Mobs-Info/work/.../MobRecipeLoader.java:1178,1244-1295(客户端清表;仅 packet 路径 addRecipe)
    • Mobs-Info/work/.../network/LoadConfigPacket.java:80-96,109-117(mobHandlerEnabled=false 发空表)
    • Mobs-Info/work/.../FMLEventHandler.java:37-40(登入才发配置)
    • NotEnoughItems/work/.../GuiCraftingRecipe.java:56-75(空 handlers → null)
    • NotEnoughItems/work/.../RecipeHandlerQuery.java:82-84(numRecipes()>0 过滤)
  • 粘原文:
GuiCraftingRecipe gui = (GuiCraftingRecipe) GuiCraftingRecipe.createRecipeGui(
    MobHandler.getInstance()
        .getOverlayIdentifier(),
    false);
if (LoaderReference.InfernalMobs.isLoaded)
    gui.currenthandlers.add(new MobHandlerInfernal().addAllRecipes());
gui.currenthandlers.add(new VillagerTradesHandler().addAllRecipes());
if (!handlers.isEmpty()) {
    final GuiCraftingRecipe gui = new GuiCraftingRecipe(handlers);
    // ...
    return gui;
}
return null;
  • 上游状态:未修

触发与复现

  • 触发条件:绑定 Mobs Info 快捷键;在 LoadConfigPacket 处理前按键,或服务端关闭 Mob Handler 后再按
  • 复现程度:静态双侧推演;建议实机「绑定键 → 进服瞬间连按 / 关 Enabled 后按」轻验
  • 包内相关性:Mobs-Info + NotEnoughItems/sides client

落点

  • 主仓:TDLM/Mobs-Info → createRecipeGui 判空后 no-op 或本地 fallback;关 Handler 时禁用键
  • 对端契约:TDLM/NotEnoughItems createRecipeGui 空返回语义保持,调用方须消化

范式

  • 命中范式:API/空返回 → 崩(邻近 C1;共装边 Mobs-Info → NEI createRecipeGui)
  • 非 C5/C8(对端非 fail-fast 抛错);非 C12

引证

  1. 本地 pin 3ea6265 / 5dbc021;wave-45 NEI 契约面

来源

  • origin/scan
**调研编号**:I-MI-KEYBIND-CREATERECIPGUI-NULL ## 现象 Mobs-Info 客户端快捷键 `Open Mobs Info GUI` 调用 NEI `GuiCraftingRecipe.createRecipeGui(overlayId, false)` 后**不判空**,直接 `gui.currenthandlers.add(...)`。 NEI 在 `handlers.isEmpty()` 时返回 `null`(`RecipeHandlerQuery` 会丢掉 `numRecipes()==0` 的 handler)。客户端 `MobHandler.cachedRecipes` 只在收到服务端 `LoadConfigPacket` 后由 `processMobRecipeMap(mobs, overrides)` 填充;主菜单/进服前、包未到、或服务端 `mobHandlerEnabled=false`(包内清表)时集合为空 → `createRecipeGui` 返回 null → 按键即客户端 NPE。 ## 危害类与优先级 - 危害类:`CRASH` - 优先级:`p2` - 标签:`type/defect`、`priority/p2`、`area/compatibility`、`origin/scan` - 后果层级:客户端崩;默认键为 `KEY_NONE`(需玩家绑定后才触发),但绑定后在「配方尚未同步 / Mob Handler 关闭」路径上可稳定复现 ## 证据(生效源码) - 载体:`TDLM/Mobs-Info` pin `3ea6265` × `TDLM/NotEnoughItems` pin `5dbc021` - 位置: - `Mobs-Info/work/.../KeyBindingHandler.java:33-41` - `Mobs-Info/work/.../MobRecipeLoader.java:1178,1244-1295`(客户端清表;仅 packet 路径 `addRecipe`) - `Mobs-Info/work/.../network/LoadConfigPacket.java:80-96,109-117`(`mobHandlerEnabled=false` 发空表) - `Mobs-Info/work/.../FMLEventHandler.java:37-40`(登入才发配置) - `NotEnoughItems/work/.../GuiCraftingRecipe.java:56-75`(空 handlers → null) - `NotEnoughItems/work/.../RecipeHandlerQuery.java:82-84`(`numRecipes()>0` 过滤) - 粘原文: ```java GuiCraftingRecipe gui = (GuiCraftingRecipe) GuiCraftingRecipe.createRecipeGui( MobHandler.getInstance() .getOverlayIdentifier(), false); if (LoaderReference.InfernalMobs.isLoaded) gui.currenthandlers.add(new MobHandlerInfernal().addAllRecipes()); gui.currenthandlers.add(new VillagerTradesHandler().addAllRecipes()); ``` ```java if (!handlers.isEmpty()) { final GuiCraftingRecipe gui = new GuiCraftingRecipe(handlers); // ... return gui; } return null; ``` - 上游状态:未修 ## 触发与复现 - 触发条件:绑定 Mobs Info 快捷键;在 `LoadConfigPacket` 处理前按键,或服务端关闭 Mob Handler 后再按 - 复现程度:静态双侧推演;建议实机「绑定键 → 进服瞬间连按 / 关 Enabled 后按」轻验 - 包内相关性:Mobs-Info + NotEnoughItems/sides `client` ## 落点 - 主仓:`TDLM/Mobs-Info` → `createRecipeGui` 判空后 no-op 或本地 fallback;关 Handler 时禁用键 - 对端契约:`TDLM/NotEnoughItems` `createRecipeGui` 空返回语义保持,调用方须消化 ## 范式 - 命中范式:**API/空返回 → 崩**(邻近 C1;共装边 Mobs-Info → NEI `createRecipeGui`) - 非 C5/C8(对端非 fail-fast 抛错);非 C12 ## 引证 1. 本地 pin `3ea6265` / `5dbc021`;wave-45 NEI 契约面 ## 来源 - `origin/scan`
layue13 added the type/defectpriority/p2area/compatibilityorigin/scan labels 2026-11-16 22:15:04 +00:00
layue13 changed title from TEMP to CRASH: 快捷键不判空 createRecipeGui 可致客户端 NPE 2026-11-16 22:15:05 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: TDLM/Mobs-Info#5