Discord.py客户端重启后登录日志重复增多问题求助

核心原因：日志处理器未被正确清理 #

你遇到的日志重复递增问题，本质是discord库的日志处理器（logging handler）没有在客户端销毁时被移除。每次创建新的discord.Client实例或后台线程时，库会自动添加新的日志处理器到全局日志器中，但旧的处理器没有被清理，导致后续登录时多个处理器同时输出同一条日志，看起来像是登录次数增加，实际只是日志重复打印。

另外你同时安装了discord.py和discord.py-self，两者的日志模块可能存在冲突或重复注册逻辑，进一步加剧了这个问题。

验证思路 #

你可以在每次重启客户端前后，打印discord日志器的处理器数量，确认是否是处理器残留：

import logging

discord_logger = logging.getLogger('discord')
print(f"当前日志处理器数量: {len(discord_logger.handlers)}")

解决方案 #

1. 手动清理日志处理器
   在停止客户端并销毁实例后，主动移除discord日志器的所有处理器：

   import logging
   
   def cleanup_discord_logs():
       discord_logger = logging.getLogger('discord')
       for handler in list(discord_logger.handlers):
           discord_logger.removeHandler(handler)
           handler.close()
   

   将这个函数放在客户端停止、线程销毁的逻辑之后调用。

2. 显式配置日志，避免自动添加处理器
   在创建discord.Client前，手动配置日志输出，禁用库的自动日志初始化：

   import logging
   
   # 自定义日志配置
   logging.basicConfig(
       level=logging.INFO,
       format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
   )
   # 获取discord日志器，禁用自动添加handler
   discord_logger = logging.getLogger('discord')
   discord_logger.propagate = False  # 避免日志向上传播到根日志器
   # 添加自定义handler（按需配置）
   handler = logging.StreamHandler()
   handler.setFormatter(logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s'))
   discord_logger.addHandler(handler)
   

   这样每次创建Client时，不会重复添加新的处理器。

3. 移除冗余库
   discord.py和discord.py-self功能重叠且可能存在兼容性问题，建议只保留你实际需要的那个库，卸载另一个：

   pip uninstall discord.py  # 或卸载discord.py-self
   

4. 确保线程资源完全回收
   在停止后台线程时，调用thread.join()等待线程完全终止，避免线程残留导致日志处理器被持有无法清理。同时确保discord.Client的close()方法被正确调用，释放所有相关资源：

   # 停止客户端
   await client.close()
   # 等待线程终止
   bg_thread.join()
   # 清理日志
   cleanup_discord_logs()
   

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