为何SonarQube对自定义与Apache的isEmpty方法空值检查表现不同？

核心原因在于SonarQube的静态分析规则预先内置了主流第三方库的方法行为契约，而自定义工具类默认不在它的识别范围内：

• Apache Commons Lang3的方法被SonarQube预先“认知”
  SonarQube的代码分析引擎里，已经为Apache Commons Lang3这类广泛使用的工具库做了特殊适配。它明确知道StringUtils.isEmpty(String)的逻辑：当该方法返回false时，传入的字符串必然非null且长度大于0。所以在你替换成Apache的工具类后，SonarQube能准确推断出后续代码中s不可能为null，不会再触发空指针风险的警告。

• 自定义工具类的方法缺少SonarQube的识别规则
  你的common.utils.StringUtil.isEmpty虽然逻辑完全一致，但SonarQube默认无法自动识别这个方法的null处理契约。它没办法通过静态分析推断出“调用该方法返回false时，参数非null”这一结论，所以依然会认为后续代码中s存在为null的可能，标记为代码异味。

可行的解决方式 #

• 给自定义的isEmpty方法添加Sonar认可的空值注解，比如@javax.annotation.Nonnull（或Sonar专属的@org.sonarsource.sonarlint.core.analyzer.commons.NonNull），明确告知分析引擎：当方法返回false时，传入的参数一定非null；
• 在SonarQube的规则配置中，手动添加自定义方法的null契约，将common.utils.StringUtil.isEmpty标记为“返回false则参数非null”的方法；
• 如果项目依赖允许，直接使用Apache Commons Lang3的StringUtils工具类，省去自定义和配置的成本。

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