在 uliweb 專案中集成 SOAP 服務後,Werkzeug 開發服務器的 INFO 級日志突然消失。根因是第三方庫 pysimplesoap 在模塊導入時調用 logging.basicConfig(level=WARNING),覆蓋了全局 Root Logger 配置,導致級別低於 WARNING 的日志被過濾。本文還原排查全過程並給出修復方案。
[INFO] * Loading DebuggedApplication...
[INFO] * Running on https://localhost:8000/
[INFO] * Restarting with reloader
[INFO] * Loading DebuggedApplication...
[INFO] * Loading DebuggedApplication...
# 後續 INFO 全無
werkzeug/serving.py):
if not logging.root.handlers and _logger.level == logging.NOTSET:
_logger.setLevel(logging.INFO)
handler = logging.StreamHandler()
_logger.addHandler(handler)
即:只有 Root Logger 無 Handler 時 才自動添加 StreamHandler 並設為 INFO。一旦 Root Logger 已有 Handler,Werkzeug 就不再添加,自身 Logger 級別仍為 NOTSET,繼承 Root 的 WARNING,導致 INFO 不輸出。
grep 發現 pysimplesoap 三個模塊各自調用 logging.basicConfig(level=WARNING),污染全局配置。[LOG.Loggers]
werkzeug = {'propagate': 0, 'level': 'info', 'format': 'format_simple'}
propagate: 0:不向 Root Logger 傳播,獨立處理。level: 'info':強制啟用 INFO 級別。「如果你在開發開放的 Python 庫,請將日志打在自己的命名空間下(如
logging.getLogger('mylib')),永遠不要調用logging.basicConfig()或修改 Root Logger,否則會不可控地影響使用者的日志系統。」
logging.basicConfig 或 dictConfig。logging.getLogger('thirdparty').setLevel(WARNING)。logging.config.dictConfig 統一管理所有 Logger、Handler、Formatter、Filter。這次排查再次驗證:全局日志配置極其脆弱,任何「好心」的 basicConfig 都可能摧毀整個應用的可觀測性。