SonarQube报抛自定义异常未携带原始异常历史Bug解决方案咨询

问题1解答 #

是的，该写法触发SonarQube告警的核心原因就是你仅将原始异常转为字符串存入自定义异常的message字段。
SonarQube的Method throws alternative exception from catch block without history（对应规则ID S1166）要求捕获异常后抛出新异常时，必须完整保留原始异常的所有上下文信息，包括异常栈轨迹、嵌套的根因异常等。你把ex直接拼接为字符串的写法，只会保留原始异常的类名和简短报错信息，完整调用栈、嵌套异常信息都会丢失，不符合规则要求。

问题2解答 #

可以根据你的实际限制选择以下两种方案，不需要修改自定义异常的现有字段类型：

方案1：修改自定义异常的构造方法，全局一次性修复 #

Java中所有异常类默认继承自Throwable父类，父类本身已经内置了异常cause存储字段和对应的initCause方法，不需要你在自定义的CustomException里额外新增字段。你只需要给CustomException新增一个带Throwable参数的构造方法即可：

class CustomException {
   HttpStatus status;
   String message;
    
   // 新增构造方法，无需改动原有字段
   public CustomException(HttpStatus status, String message, Throwable cause) {
       this.status = status;
       this.message = message;
       // 直接调用父类Throwable的方法保存原始异常
       super.initCause(cause);
   }
    
   // 原有Getter、Setter、其他构造方法保持不变
 }

后续抛出异常时只需调整构造参数即可，相比逐行调用initCause代码更简洁，配合IDE全局替换功能修改成本极低。

方案2：确认无需保留原始异常栈的场景下，抑制SonarQube告警 #

如果你的业务场景确实不需要保存原始异常栈，不想调整异常抛出逻辑，可以在触发告警的方法或者代码行上添加抑制告警的注解：

@SuppressWarnings("squid:S1166")
public void yourBusinessMethod() {
    // 原有代码逻辑
}

该注解会让SonarQube跳过当前代码的对应规则校验，不需要改动业务逻辑。

内容的提问来源于stack exchange，提问作者ima.technophyle