使用Watchdog线程监控下载目录时日志无输出问题排查

1. 日志配置没到位 #

• 默认日志级别是WARNING，如果你的日志用的是debug或info级别，控制台不会输出。得手动设置日志级别：

  import logging
  logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
  

• 检查Watcher和DownloadHandler里的日志代码，有没有正确初始化logger（比如logger = logging.getLogger(__name__)），有没有写错日志语句（比如把logger.info写成log.info）。

2. 监控线程没跑起来或提前挂了 #

• 确认有没有调用线程的start()方法，光实例化线程对象没用。
• 主线程下载完直接退出的话，子线程会被强制终止。比如主线程下载后没加thread.join()，也没写个循环保持运行（比如while True: time.sleep(1)），Watchdog线程还没干活就没了。
• 检查Watchdog的Observer是否正确启动：必须调用observer.start()，而且主线程退出前要调用observer.join()，不然Observer线程会直接结束。

3. 文件事件没触发 #

• 核对监控的下载路径：是不是写错了（比如相对路径不对、大小写错了），或者下载的文件根本没存到这个目录里。
• 很多下载工具先写临时文件（比如带.tmp后缀），完成后才重命名。如果你的DownloadHandler只监听on_created事件，会漏掉重命名后的最终文件，得同时监听on_moved事件。
• 检查事件方法的拼写：比如是不是把on_created写成on_create，或者on_moved写成on_move，方法名错了就不会被调用。

4. 事件逻辑里的异常被吞了 #

• 如果事件处理方法里（比如移动文件的逻辑）抛出异常但没捕获，线程会静默崩溃，不会输出日志。比如权限不够、目标目录不存在，都可能出问题。建议加try-except打日志：

  def on_created(self, event):
      try:
          # 你的文件移动代码
      except Exception as e:
          logging.error(f"处理文件出错: {str(e)}")
  

5. 守护线程导致提前退出 #

• 如果监控线程被设为daemon=True，主线程一结束，守护线程就立刻终止。要是主线程下载速度快，监控线程还没开始工作就没了。检查线程创建时的参数，别随便设daemon为True。

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