Java 线程池中怎么通过自定义 RejectedExecutionHandler 处理溢出任务

舞姬之光

舞姬之光

2026-08-04

657人浏览

原创

当线程池任务队列已满且线程数达最大值时,新任务被拒绝,可通过自定义rejectedexecutionhandler实现日志、降级等策略;java内置四种策略,但业务常需扩展;自定义handler需在构造threadpoolexecutor时传入,避免阻塞操作和无限重试。

java 线程池中怎么通过自定义 rejectedexecutionhandler 处理溢出任务

当线程池任务队列已满且线程数达到最大值时,新提交的任务会被拒绝。此时可通过自定义 RejectedExecutionHandler 控制拒绝策略,而不是直接抛出 RejectedExecutionException

理解拒绝时机与默认策略

拒绝发生在 execute() 调用时,前提是:

  • 核心线程数已满
  • 任务队列已满(如 ArrayBlockingQueue 容量耗尽)
  • 非核心线程也已创建到 maximumPoolSize

Java 提供四种内置策略:AbortPolicy(抛异常)、CallerRunsPolicy(由提交线程执行)、DiscardPolicy(静默丢弃)、DiscardOldestPolicy(丢弃队首任务再重试)。但它们无法满足日志记录、降级、异步补偿等业务需求。

实现自定义 RejectedExecutionHandler

只需实现 RejectedExecutionHandler 接口,重写 rejectedExecution(Runnable r, ThreadPoolExecutor executor) 方法:

  • 参数 r:被拒绝的原始任务(可能是 FutureTask 或普通 Runnable
  • 参数 executor:当前线程池实例,可用于获取状态(如 getActiveCount()getQueue().size()
  • 方法内可做日志、落库、发消息、调用备用服务等,但避免阻塞或耗时操作,否则可能拖慢提交线程

示例:记录日志并尝试写入 Kafka 备份队列(非阻塞发送):

Java JDK 25
Java JDK 25

Java JDK 25 来自 OpenJDK 官方归档,版本为 JDK 25,本条下载地址已指向官方 Windows x64 zip 安装包直链,适合调试旧项目或兼容旧版 Java 运行环境。

下载
public class LogAndRetryHandler implements RejectedExecutionHandler {
  private final KafkaProducer producer;

  public LogAndRetryHandler(KafkaProducer producer) {
    this.producer = producer;
  }

  @Override
  public void rejectedExecution(Runnable r, ThreadPoolExecutor executor) {
    log.warn("Task rejected: {}, pool: active={}, queue={}",
      r.getClass().getSimpleName(),
      executor.getActiveCount(),
      executor.getQueue().size());
    // 异步发送到 Kafka,不阻塞
    producer.send(new ProducerRecord("rejected-tasks", r.toString()));
  }
}

注册到线程池的正确方式

必须在构建线程池时传入自定义 handler,不能后期替换:

  • 使用 ThreadPoolExecutor 构造器时第 8 个参数传入实例
  • 若用 Executors 工具类(如 newFixedThreadPool),其内部固定使用 AbortPolicy,无法更换 —— 所以务必手动构造 ThreadPoolExecutor
  • Spring 中可通过 @Bean 定义线程池,并注入自定义 handler

关键代码片段:

ThreadPoolExecutor executor = new ThreadPoolExecutor(
  corePoolSize, maximumPoolSize,
  keepAliveTime, TimeUnit.SECONDS,
  new ArrayBlockingQueue(queueCapacity),
  new CustomThreadFactory(),
  new LogAndRetryHandler(kafkaProducer)
);

注意事项与常见陷阱

自定义 handler 看似简单,但容易踩坑:

  • 不要在 handler 中调用 executor.execute(r) 重试 —— 可能再次触发拒绝,造成无限递归或栈溢出
  • 避免同步 I/O(如写文件、远程 HTTP 调用),推荐异步、缓冲、带超时的轻量操作
  • 若任务本身携带上下文(如用户 ID、TraceID),应在 handler 中提取并记录,便于问题追踪
  • 测试时需模拟满负荷场景(如快速提交超量任务),验证 handler 是否按预期触发

不复杂但容易忽略细节。关键是把拒绝当成可观测事件来设计,而非错误兜底。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

3745

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

2776

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

2799

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

636

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

601

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

705

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1289

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

18844

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

646

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
SQL优化与排查(MySQL版)
SQL优化与排查(MySQL版)

共26课时 | 2.9万人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习