在Java并发编程里，线程的创建方式直接影响系统的可维护性与问题排查效率。JDK并发包中提供的ThreadFactoryBuilder是一种通过链式调用定制ThreadFactory的辅助工具，它把线程命名规则、是否守护线程、优先级以及异常处理器等参数集中配置，避免到处散落new Thread的写法。
ThreadFactoryBuilder是什么
ThreadFactoryBuilder是JDK（具体位于com.google.common.util.concurrent或早期sun内部工具衍生出的约定写法，在主流第三方与JDK辅助代码中常作为构建器模式示例）中用于构造ThreadFactory实例的构建类。它的核心思想是：把创建线程所需的各种属性先暂存到构建器对象里，最后调用build方法产出一个固定行为的工厂。
这种构建器与直接实例化ThreadFactory匿名类相比，优势在于可读性强。例如我们想让线程池里的线程都以“order-worker-”开头，并且出现异常时打印日志，用构建器只需连续调用几个语义化方法。传统写法要在run中包裹try-catch或重写uncaughtException，代码分散且易漏配。
核心配置方法
常见的链式方法包括setNameFormat、setDaemon、setPriority、setUncaughtExceptionHandler。setNameFormat支持类似“rpc-pool-%d”的格式化串，构建器会在每次newThread时自动替换序号，保证名称不重复。
setDaemon用于指定线程是否为守护线程，若业务线程误设为守护，可能导致JVM退出时任务未跑完。setUncaughtExceptionHandler则接收Thread.UncaughtExceptionHandler接口，在run方法抛出未捕获异常时回调，对监控非常关键。
链式调用示例
下面是一段使用ThreadFactoryBuilder风格（以Guava实现为例）创建线程工厂并用于线程池的代码。注意其中特殊字符已转义，仅作文本展示。
import com.google.common.util.concurrent.ThreadFactoryBuilder;
import java.util.concurrent.ExecutorService;
import java.util.concurrent.Executors;
import java.util.concurrent.ThreadFactory;
public class Demo {
public static void main(String[] args) {
ThreadFactory factory = new ThreadFactoryBuilder()
.setNameFormat("biz-pool-%d")
.setDaemon(false)
.setPriority(Thread.NORM_PRIORITY)
.setUncaughtExceptionHandler((t, e) -> {
System.err.println("thread " + t.getName() + " error");
e.printStackTrace();
})
.build();
ExecutorService pool = Executors.newFixedThreadPool(4, factory);
pool.execute(() -> {
System.out.println(Thread.currentThread().getName());
throw new RuntimeException("test error");
});
pool.shutdown();
}
}
上面代码在运行时，线程名会输出为biz-pool-0之类，异常也会被我们设定的处理器捕获并打印。若不用构建器，就得自己写完整ThreadFactory实现类，样板代码明显更多。
在真实服务中，还可以把factory注入到多个线程池，统一全应用的线程命名规范。这样在jstack或日志中看到biz-pool-1就能立刻知道归属模块，不用再翻代码确认。
与默认工厂的对比
Executors工具类自带的默认ThreadFactory创建的线程名形如pool-N-thread-M，且无异常处理器、非守护。当系统存在多个线程池时，这种名字很难区分业务。下表列出差异：
| 维度 | 默认工厂 | ThreadFactoryBuilder |
|---|---|---|
| 线程命名 | pool-N-thread-M | 可自定义格式 |
| 异常处理器 | 无 | 可设置 |
| 守护状态 | 非守护 | 可指定 |
| 优先级 | 普通 | 可调整 |
从表中可见，构建器在可观测性与控制力上全面占优。虽然多写几行构建代码，但换来了稳定的运维体验。
需要提醒的是，若项目中没有引入Guava，也可以参照其源码自行实现一个简化版ThreadFactoryBuilder，核心只是用成员变量保存配置并在newThread中应用。重点是养成通过工厂统一产出线程的习惯，而不是在业务代码里随处写new Thread。
使用注意事项
第一，setNameFormat中的%d不要漏写，否则所有线程同名，反而干扰排查。第二，异常处理器里尽量做异步日志或计数，不要执行重IO，避免影响出错线程所在池的吞吐。
第三，构建器本身不是线程安全的，通常只在初始化阶段使用，构建出factory后传给线程池即可，不必每次提交任务都build一次。遵循这些细节，链式调用就能稳定产出高质量线程。
ThreadFactoryBuilderJDK并发包链式调用修改时间：2026-08-05 05:39:24