Python ThreadPoolExecutor shutdown行为随调用位置差异的问题

这个差异的核心在于ThreadPoolExecutor对象的生命周期以及Python垃圾回收的时机，结合线程池线程的守护属性共同导致：

1. 全局作用域的情况
   全局变量executor会一直存在到程序即将退出的时刻。此时Python会触发它的__del__方法，而该方法内部会自动调用shutdown(wait=True)——这会强制等待所有已提交的任务执行完毕，才会让程序真正退出。这和你观察到的“剩余future执行完毕”的现象一致，也符合官方文档的隐含前提（Executor对象未被提前销毁）。

2. 函数内部的情况
   函数内的executor是局部变量，函数执行完毕后就会被标记为可回收垃圾。但Python的垃圾回收不会立即执行，主线程会继续走到程序末尾并准备退出。而ThreadPoolExecutor创建的线程默认是守护线程，主线程退出时会直接终止所有守护线程，导致未完成的任务被强制取消。即使后续垃圾回收触发了executor.__del__，此时任务线程已经被终止，无法继续执行。

• 验证方式：在函数末尾添加time.sleep(3)（时长需超过任务执行时间），此时垃圾回收会有足够时间触发executor.__del__，你会看到任务能正常执行完毕。
• 解决办法：
  • 方法一：让executor对象的生命周期覆盖任务执行时间，比如将其声明为全局变量，或者在函数外保留引用。
  • 方法二：在函数内调用shutdown(wait=True)，主动等待所有任务完成后再让函数返回。
  • 方法三：手动触发垃圾回收，在函数末尾添加import gc; gc.collect()，强制回收executor并触发__del__里的等待逻辑。

内容的提问来源于stack exchange，提问作者Murray Rogers