要让Dubbo消费者端直接收到提供者抛出的自定义业务异常，需绕过默认ExceptionFilter并用自定义Filter透传：满足包名白名单（如com.example.biz.exception）即原样抛出，同时禁用内置filter，消费者可直接catch原始异常。
要让 Dubbo 消费者端直接收到提供者抛出的自定义业务异常（比如 com.example.biz.exception.BusinessException），而不是被包装成 RpcException 或 RuntimeException，关键在于**绕过 Dubbo 默认的 ExceptionFilter，并用自定义 Filter 控制透传逻辑**。默认情况下，Dubbo 只对 checked 异常、JDK 异常、Dubbo 自身异常及接口方法签名中声明的异常做透传，而多数业务异常继承自 RuntimeException 且未在方法签名中 throws，就会被拦截封装。
确认自定义异常满足透传前提
Dubbo 原生 ExceptionFilter 的透传规则（源码逻辑）如下，只有满足任一条件才会原样抛出：
- 是 checked 异常（即
exception instanceof Exception && !(exception instanceof RuntimeException)） - 该异常类明确出现在服务接口方法的
throws子句中 - 异常类与服务接口类在同一个 ClassLoader 加载，且属于同一 jar 包（常见于 provider model 和 common model 分离部署时失效）
- 异常类名以
java.或javax.开头（JDK 标准异常） - 是
RpcException等 Dubbo 内部异常
因此，若你的自定义异常包名为 com.example.biz.exception，且继承 RuntimeException，又没在接口方法上声明 throws，就必然被拦截 —— 这正是需要自定义 Filter 的原因。
编写自定义 ExceptionFilter
复制 Dubbo 源码中的 ExceptionFilter（如 org.apache.dubbo.rpc.filter.ExceptionFilter），重命名为 CustomExceptionFilter，重点修改透传判断逻辑：
- 添加对指定包名的白名单支持，例如：
if (exception.getClass().getName().startsWith("com.example.biz.exception")) { return; } - 保留原有日志记录和非透传异常的封装逻辑（如包装为
RpcException） - 使用
@Activate(group = CommonConstants.PROVIDER)确保只在服务提供方生效
注意：务必排除 GenericService 场景（避免影响泛化调用），并确保 onMessage 方法中不干扰正常响应流程。
在调试 Java 后端 API 故障时使用此技能，尤其适用于以下任务：分析日志、跨 Controller、Service 和 Mapper 层追踪请求、定位异常根因、检查 SQL 执行或参数流转，以及生成简洁的诊断结论与修复方案。
注册并启用自定义 Filter
两步完成启用：
- 在
src/main/resources/META-INF/dubbo/com.apache.dubbo.rpc.Filter文件中添加一行：customExceptionFilter=com.example.filter.CustomExceptionFilter - 在 provider 端的 Dubbo 配置（XML 或 properties）中显式启用它，并禁用默认过滤器：
其中-exception表示移除 Dubbo 内置的ExceptionFilter，防止双重处理
若使用 Spring Boot + Dubbo 3.x，也可通过 @DubboService(filter = "customExceptionFilter,-exception") 在单个服务上配置。
消费者端无需额外配置
只要提供者端成功透传，消费者调用时就能直接 catch 到原始异常类型，例如：
try {userService.login("u1");
} catch (BusinessException e) { // com.example.biz.exception.BusinessException
// 直接处理业务错误码和消息
}
此时异常对象完整保留了字段（如 errorCode、message），序列化/反序列化过程由 Dubbo 协议自动完成，前提是消费者项目中存在同名同版本的异常类（否则会因 ClassNotFoundException 降级为 RpcException）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
