ElasticJob 中 throw 抛出的异常不会自动触发 JobErrorHandler，除非该异常从 execute() 等核心方法未被捕获地抛出，且为 RuntimeException 子类；需显式注册 JobErrorHandler 实现类，异步线程或已捕获异常均不触发。
在 ElasticJob 中，throw 抛出的异常**不会自动触发 JobErrorHandler**，除非该异常发生在作业执行的核心方法（如 execute()）中，且未被业务代码捕获。ElasticJob 的错误处理器只对作业主流程中“未被捕获的异常”生效。
JobErrorHandler 触发的前提条件
JobErrorHandler 是 ElasticJob 提供的扩展点，用于统一处理作业执行过程中抛出的、未被 catch 的运行时异常。它只在以下情况下被调用：
- 异常从
SimpleJob.execute()或DataflowJob.fetchData()/processData()等核心方法中直接向上抛出； - 异常类型是
RuntimeException或其子类（检查型异常如IOException默认不触发，除非配置了ignoreFailover或自定义逻辑）； - 作业实例未被主动中断（如
jobExecutionContext.isStopped()为 true 时，部分版本可能跳过错误处理）。
确保 throw 能触发 JobErrorHandler 的写法
不要在 execute() 内部吞掉异常，也不要用空 catch 块。正确示例如下：
public class MySimpleJob implements SimpleJob {
@Override
public void execute(ShardingContext context) {
// ✅ 正确：让异常自然抛出
if (context.getShardingItem() == 0) {
throw new RuntimeException("分片0执行失败，触发JobErrorHandler");
}
// ❌ 错误：捕获后没重新抛出 → JobErrorHandler 不会触发
// try { riskyOperation(); } catch (Exception e) { log.error(e); }
}
}
注册 JobErrorHandler 的方式
需通过 JobConfiguration 显式指定实现类，或使用 Spring Boot 自动装配（ElasticJob-Lite 3.x+）：
立即学习“Java免费学习笔记（深入）”；
- Java API 方式：
jobConfig.setJobErrorHandlerClass(MyJobErrorHandler.class); - Spring Boot 方式：定义
@Bean返回JobErrorHandler实现，并确保JobScheduler加载了该 Bean； - 注意：若多个作业共用同一
JobErrorHandler，需在实现中通过jobName区分处理逻辑。
常见误区与补充说明
以下情况 不会 触发 JobErrorHandler：
- 异常发生在异步线程（如
CompletableFuture、线程池任务）中 —— 主线程无异常，无法感知； - 异常被
try-catch捕获后仅打日志或返回错误码 —— 流程正常结束，ElasticJob 认为执行成功； - 使用
JobListener替代JobErrorHandler—— 前者监听生命周期，后者专管未捕获异常； - ElasticJob 2.x 版本中，
JobErrorHandler默认实现为空，需自行实现并注册，否则无声忽略异常。
