opengoofy /hippo4j

📌 异步线程池框架,支持线程池动态变更&监控&报警,无需修改代码轻松引入。Asynchronous thread pool framework, support Thread Pool Dynamic Change & monitoring & Alarm, no need to modify the code easily introduced.

★ 5,999⑂ 1,235👁 75⑃ 910● 696▤ 18
JavaApache-2.0Created 2021-06-16hippo4j.github.io
下载:1.5.0 (Apr 15, 2023)1.5.0 ↓1.5.02023-04-15
+0
日增长
5,999
stars
1,235
forks
75
watchers
910
prs
696
issues
18
releases

README

动态可观测线程池,提高系统运行保障能力





!
!
!





 📢 新项目
 
 Ragent AI(点击跳转) —— 企业级 Agentic RAG 项目,拿个 offer 社群在 AI 领域的首个开源作品。架构设计、代码实现保持一贯的高标准,适合写进校招/社招简历。毕竟现在哪家公司不关注 AI?


 线程池痛点

---

线程池是一种基于池化思想管理线程的工具,使用线程池可以减少创建销毁线程的开销,避免线程过多导致系统资源耗尽。在高并发以及大批量的任务处理场景,线程池的使用是必不可少的。

如果有在项目中实际使用线程池,相信你可能会遇到以下痛点:

- 线程池随便定义,线程资源过多,造成服务器高负载。

- 线程池参数不易评估,随着业务的并发提升,业务面临出现故障的风险。
- 线程池任务执行时间超过平均执行周期,开发人员无法感知。
- 线程池任务堆积,触发拒绝策略,影响既有业务正常运行。
- 当业务出现超时、熔断等问题时,因为没有监控,无法确定是不是线程池引起。
- 原生线程池不支持运行时变量的传递,比如 MDC 上下文遇到线程池就 GG。
- 无法执行优雅关闭,当项目关闭时,大量正在运行的线程池任务被丢弃。
- 线程池运行中,任务执行停止,怀疑发生死锁或执行耗时操作,但是无从下手。

 什么是 Hippo4j

---

提供以下功能支持:

- 全局管控 - 管理应用线程池实例。

- 动态变更 - 应用运行时动态变更线程池参数,包括但不限于:核心、最大线程数、阻塞队列容量、拒绝策略等。
- 通知报警 - 内置四种报警通知策略,线程池活跃度、容量水位、拒绝策略以及任务执行时间超长。
- 数据采集 - 支持多种方式采集线程池数据,包括但不限于:日志、内置采集、Prometheus、InfluxDB、ElasticSearch 等。
- 运行监控 - 实时查看线程池运行时数据,自定义时间内线程池运行数据图表展示。
- 功能扩展 - 支持线程池任务传递上下文;项目关闭时,支持等待线程池在指定时间内完成任务。
- 多种模式 - 内置两种使用模式:依赖配置中心 和 无中间件依赖。
- 容器管理 - Tomcat、Jetty、Undertow 容器线程池运行时查看和线程数变更。
- 框架适配 - Dubbo、Hystrix、RabbitMQ、RocketMQ 等消费线程池运行时数据查看和线程数变更。
- 变更审核 - 提供多种用户角色,普通用户变更线程池参数需要 Admin 用户审核方可生效。
- 动态化插件 - 内置多种线程池插件,支持用户自定义插件以及运行时扩展。
- 多版本适配 - 经过实际测试,已支持客户端 SpringBoot 1.5.x = 2.7.5 版本(更高版本未测试)。

 架构设计

---


 快速开始

---

对于本地演示目的,请参阅 Quick start

演示环境: http://console.hippo4j.cn/index.html

 接入登记

---

更多接入的公司,欢迎在 登记地址 登记,登记仅仅为了产品推广。

 联系我

---

开源不易,右上角点个 Star 鼓励一下吧!

如果大家想要实时关注 Hippo4j 更新的文章以及分享的干货的话,可以关注我的公众号。

使用过程中有任何问题,或者对项目有什么建议,关注公众号回复:加群,和 1000+ 志同道合的朋友交流讨论。




 深入原理

---

如果您公司没有使用 Hippo4j 场景的话,我也建议去阅读下项目的底层原理,主要有以下几个原因:

- 为了提高代码质量以及后续的扩展行为,运用多种设计模式实现高内聚、低耦合。

- 框架底层依赖 Spring 框架运行,并在源码中大量使用 Spring 相关功能。
- 运用 JUC 并发包下多种工具保障多线程运行安全,通过实际场景理解并发编程。
- 借鉴主流开源框架 Nacos、Eureka 实现轻量级配置中心和注册中心功能。
- 自定义 RPC 框架实现,封装 Netty 完成客户端/服务端网络通信优化。
- 通过 CheckStyle、Spotless 等插件规范代码编写,保障高质量代码行为和代码样式。

 友情链接

---

- [[ Sa-Token ]](https://github.com/dromara/sa-token):一个轻量级 java 权限认证框架,让鉴权变得简单、优雅!

- [[ HertzBeat ]](https://github.com/dromara/hertzbeat):易用友好的云监控系统, 无需 Agent, 强大自定义监控能力。
- [[ JavaGuide ]](https://github.com/Snailclimb/JavaGuide):一份涵盖大部分 Java 程序员所需要掌握的核心知识。
- [[ toBeBetterJavaer ]](https://github.com/itwanger/toBeBetterJavaer):一份通俗易懂、风趣幽默的 Java 学习指南。
- [[ Jpom ]](https://gitee.com/dromara/Jpom):简而轻的低侵入式在线构建、自动部署、日常运维、项目监控软件。
- [[ 12306 ]](https://gitee.com/nageoffer/12306):完成高仿 12306 用户+抢票+订单+支付服务,帮助学生主打就业的项目。
- [[ CongoMall ]](https://gitee.com/nageoffer/congomall):企业级商城,基于 DDD 领域驱动模型开发,包含商城业务和基础架构。

 贡献者

---

感谢所有为项目作出贡献的开发者。如果有意贡献,参考 good first issue。





 鸣谢

---

Hippo4j 社区收到 Jetbrains 多份 Licenses,并已分配项目 活跃开发者,非常感谢 Jetbrains 对开源社区的支持。

!JetBrains Logo (Main) logo

Top issues

Discussions

Latest release

1.5.0 (Apr 15, 2023) v1.5.0 2023-04-15
此版本拥有较多功能的增强,建议按照当前版本进行升级。具体信息可查看 Release 标签地址:1.5.0

 Use Change

- [Config] 配置属性中容器线程池配置命名改为 spring.dynamic.thread-pool.web。

- [Server] 为了使语义更加明确,当前版本中线程池执行超时时间的最低可设置为-1,表示不设置超时。需要注意的是,如果客户端使用的是低于1.5.0的版本,可能会存在不兼容的情况。

- [Common] 为了使语义更加明确,废弃 ThreadPoolBuildermaxPoolNum,新增加 ThreadPoolBuildermaximumPoolSize,原 API 还可以使用,将在后续版本删除。

 Feature

- [1124 ] Config 模式支持 Web 容器配置修改通知 @yanrongzhen
- [1148 ] 优化执行时间超时 executeTimeOut 为空或 <= 0 的场景 @sususama
- [1128 ] 控制台前端国际化开发 @Svamei @ PleasePerfunctory
- [1068 ] 默认线程池配置填充至线程池实例 @magestacks 
- [1055 ] 适配第三方自定义线程池,支持外部SPI方式扩展线程池类型 @lingfen

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON