如何配置IntelliJ自定义检测规则识别非原始类型Boolean的if条件空指针风险

方案1：调整内置检查规则（无需自定义开发） #

IntelliJ IDEA 自带对应场景的检查规则，仅需修改默认配置即可覆盖所有包装类型Boolean的拆箱场景，无需依赖@Nullable注解：

• 打开Settings/Preferences → Editor → Inspections → Java → Probable bugs
• 找到名为 Unboxing of 'Boolean' that may produce 'NullPointerException' 的检查项
• 勾选配置项中的 Report all unboxing of java.lang.Boolean
• 根据需求调整告警级别（比如设置为 Warning 或 Error）即可，该规则会同时覆盖方法返回值、局部变量等所有Boolean类型自动拆箱的场景，包括if判断、三目运算等场景。

方案2：自定义结构搜索检查规则 #

如果需要更灵活的定制（比如仅检测if判断场景，不报警其他拆箱场景），可以通过结构搜索自定义检查规则：

• 进入Settings/Preferences → Editor → Inspections
• 点击页面右上角的加号，选择Add Structural Search Inspection
• 搜索模板填入如下内容：

if ($expr$) {
    $statement$;
}

• 点击Edit Variables按钮，选中expr变量做如下配置：
  • Expression type (regexp) 字段填入 java.lang.Boolean
  • 勾选Apply constraint within type hierarchy
• 自定义检查项的提示文案（比如 包装类型Boolean直接用于if判断可能触发NullPointerException，请显式处理空值）、告警级别后保存即可。

推荐修复方案 #

触发告警后可任选以下方式规避空指针风险：

• 使用equals比较避免空指针：if (Boolean.TRUE.equals(getCondition()))
• 显式做空值兜底：if (getCondition() != null && getCondition())
• 用Optional处理空值：if (Optional.ofNullable(getCondition()).orElse(false))

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