Python Logging异常清空日志文件问题排查求助

核心结论：多个模块导入logging本身无影响，问题根源是重复初始化日志配置 #

Python的logging模块是单例模式，多个模块导入的是同一个日志器实例，本身不会引发问题。但你的日志配置用了filemode='w'（覆盖模式），如果多次执行logging.basicConfig，每次都会以覆盖模式打开日志文件，直接清空原有内容，这就是日志忽增忽减、崩溃时清空的核心原因。

注意：默认情况下，basicConfig只会在根日志器没有任何handler时生效；但如果代码中存在手动移除handler、或者使用force=True参数调用basicConfig，就会强制重新配置，触发文件覆盖。

具体排查方向 #

• 排查logging.basicConfig的重复调用：
  • 检查所有模块中是否有调用logging.basicConfig的代码，包括被多次导入的子模块、存在循环导入的模块（比如模块A导入B，B又导入A，导致初始化代码重复执行）。
  • 检查是否在函数、循环内部调用了basicConfig，比如每次执行某个函数都重新配置日志，导致反复覆盖文件。
• 排查多进程/多线程场景：
  • 如果程序使用了多进程（比如multiprocessing模块），每个子进程都会重新执行初始化代码，调用basicConfig时用w模式会直接覆盖父进程的日志文件，导致文件大小频繁波动。
  • 多线程本身不会引发该问题，但如果线程中存在手动重新配置日志的逻辑，也可能触发文件覆盖。
• 排查异常崩溃时的执行路径：
  • 程序崩溃前，是否刚好执行了某个会触发日志重新配置的代码？比如某个异常处理块中调用了basicConfig，导致打开文件清空内容后，程序直接崩溃，没来得及写入日志，最终文件为空。
• 排查是否手动操作了日志handler：
  • 检查代码中是否有手动移除根日志器handler的逻辑（比如logging.root.handlers.clear()），之后再调用basicConfig会重新创建handler，触发w模式覆盖文件。

临时修复建议 #

1. 将filemode='w'改为filemode='a'（追加模式），即使重复配置，也只会追加内容而不会清空文件，但这只是治标，仍需找到重复配置的根源。
2. 确保logging.basicConfig只在程序启动时执行一次，比如放在main.py的最顶层，且仅在if __name__ == '__main__':块中执行，避免模块被导入时重复执行。
3. 如果是多进程场景，建议每个进程使用独立的日志文件，或者使用进程安全的日志handler（比如QueueHandler+QueueListener）。

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