Python导入模块__init__.py日志消息丢失问题的解决方法咨询

给你三个实用的解决思路，按需选择：

1. 提前配置脚本日志（最简单方案） #

虽然规范说导入语句放开头，但日志配置属于脚本的初始化前置操作，完全可以放在所有导入之前。比如：

# 先把日志配置写在最前面
import logging
logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(levelname)s - %(message)s'
)

# 再导入你的库
import my_custom_lib

# 后续业务代码

这种方式几乎不需要修改库的代码，导入库时root日志已配置完成，__init__.py里输出的日志会被正常捕获，不会丢失。

2. 让库的日志自适应外部配置 #

修改库的__init__.py，让日志只在没有外部配置时启用默认处理器，避免冲突和丢失：

import logging

# 获取库专属的logger
logger = logging.getLogger(__name__)
logger.setLevel(logging.INFO)

# 只有当root logger无任何处理器时，才添加库的默认输出
if not logging.getLogger().handlers:
    handler = logging.StreamHandler()
    formatter = logging.Formatter('%(asctime)s - %(name)s - %(levelname)s - %(message)s')
    handler.setFormatter(formatter)
    logger.addHandler(handler)
    # 关闭传播，避免后续外部配置日志时重复输出
    logger.propagate = False

# 环境变量解析逻辑
logger.info("正在加载环境文件...")
# 模拟解析过程
# ...

不管脚本是否提前配置日志，库的日志都能正常输出：脚本提前配置就用脚本的规则，没配置就用库的默认配置，完全不影响脚本的导入规范。

3. 延迟环境变量初始化（适合重初始化场景） #

把__init__.py里的环境变量解析和日志逻辑，从顶层代码移到初始化函数里，让用户（或库内部）按需触发：

# 库的__init__.py
import logging

logger = logging.getLogger(__name__)
_env_ready = False
env_settings = {}

def init_environment():
    """初始化环境变量，可由用户主动调用，或库内部自动触发"""
    global _env_ready, env_settings
    if _env_ready:
        return
    logger.info("开始解析环境配置...")
    # 这里写环境文件解析、默认值设置逻辑
    # 比如：env_settings = load_dotenv(...)
    logger.info("环境配置加载完成")
    _env_ready = True

# 库的功能模块里，使用环境变量前先触发初始化
def some_core_function():
    init_environment()
    # 使用env_settings里的配置
    # ...

脚本里可以先配日志，再导入库并初始化：

import logging
logging.basicConfig(level=logging.INFO)

import my_custom_lib
# 主动初始化环境（或第一次调用库功能时自动触发）
my_custom_lib.init_environment()

这种方式把初始化的控制权交给用户，适合环境解析逻辑较重、或需要自定义初始化时机的场景。

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