默认线程名如pool-1-thread-1缺乏业务上下文，导致调试困难；必须自定义threadfactory在创建时设名，避免复用导致混淆，且需控制长度、禁用空格/特殊字符、显式设置守护状态。
为什么默认线程名根本没法 debug
Java 默认的 ThreadFactory 创建的线程叫 pool-1-thread-1 这种，一跑多线程就全是编号，堆栈里看到 pool-2-thread-7 完全不知道它属于哪个业务模块、哪个定时任务、哪次 RPC 调用。线上出问题时连日志都对不上号。
真正有用的线程名得带上下文：比如 order-pay-worker-1、mq-consumer-retry-3。这要求你必须自定义 ThreadFactory，而不是靠事后改名（Thread.setName() 在池里不生效）。
- 线程一旦被复用，名字不会自动更新；必须在创建时就设好
-
Executors.defaultThreadFactory()不提供扩展点，只能自己重写 - 别在
run()里动态改名——线程池调度器认的是创建时的名字
怎么写一个靠谱的 ThreadFactory 实现
核心就两件事：命名 + 设置守护状态。不要加日志、不要做耗时操作，否则会拖慢线程创建，甚至引发线程饥饿。
推荐直接用 Thread.ofVirtual()（JDK 21+）以外的场景，老老实实 new 一个匿名类或 Lambda（注意捕获变量安全）：
ThreadFactory namedFactory = threadGroup -> {
Thread t = new Thread(threadGroup, "search-task-" + counter.getAndIncrement());
t.setDaemon(false); // 关键：根据业务决定是否守护
t.setPriority(Thread.NORM_PRIORITY);
return t;
};
- 线程名里避免空格、斜杠、控制字符，有些监控系统（如 Arthas）解析会出错
- 务必调用
t.setDaemon(false)，否则主线程退出后池子可能被静默销毁 - 不要在工厂里做
Thread.sleep()或锁操作，ThreadPoolExecutor 的prestartCoreThread()会卡住 - 如果用
AtomicInteger计数，注意高并发下名字重复概率极低，但别用new Random().nextInt()—— 没必要且有性能开销
Spring Boot 里怎么注入带名称的线程池
Spring 的 @Bean 方法里配线程池时，很多人只设了核心参数，漏掉 ThreadFactory，结果还是看到 task-1 这种泛化名。
正确姿势是把命名逻辑和线程池解耦，单独声明一个 ThreadFactory Bean：
@Bean
public ThreadFactory searchTaskThreadFactory() {
return new NamedThreadFactory("search-worker");
}
@Bean
public ThreadPoolTaskExecutor searchTaskExecutor() {
ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
executor.setCorePoolSize(4);
executor.setMaxPoolSize(8);
executor.setThreadFactory(searchTaskThreadFactory()); // ← 必须显式设置
executor.setWaitForTasksToCompleteOnShutdown(true);
return executor;
}
- Spring 的
ThreadPoolTaskExecutor不会自动使用spring.task.execution.pool.thread.name-prefix给每个线程命名——那只是给内部默认工厂用的，自定义工厂会覆盖它 - 如果用了
@Async，确保@EnableAsync配的AsyncConfigurer返回的getAsyncExecutor()也用了你的命名工厂 - 别在
@PostConstruct里手动调setThreadFactory()，Bean 初始化顺序不可靠
线程名长度和监控系统的实际限制
看似只是个字符串，但不同环境对线程名长度敏感：Linux /proc/pid/status 里 comm 字段只截取前 15 字节；JFR（Java Flight Recorder）默认记录前 16 字符；Arthas 的 thread -n 命令也按固定宽度显示。
- 建议控制在线程名总长 ≤ 12 个英文字符 + 连字符 + 数字，例如
pay-w-1、cache-r-3 - 别塞 UUID 或时间戳——既无必要又占空间，
pay-w-1698745230123和pay-w-1在排查时信息量几乎一样 - 如果业务需要区分租户或 traceId，优先走 MDC 或日志上下文，而不是硬塞进线程名——线程名是静态标识，不是运行时上下文容器
线程名不是越详细越好，而是要在可读性、一致性、兼容性之间找平衡点。起名那一刻，就想好三个月后你能不能在 200 行堆栈里一眼认出它。
