问题背景
在使用Python的uvicorn库运行ASGI应用时，开发者常通过log_warning方法记录警告信息。然而，一个高频问题是日志重复输出：同一条警告信息在控制台或文件中多次打印，导致日志冗余和调试困难。这种现象通常与日志处理器链、多线程环境或第三方库冲突有关。
根本原因分析
日志重复输出的核心原因包括：
- 处理器叠加：uvicorn默认的日志配置可能与其他库（如logging模块）的处理器重叠。
- 多级传播：日志消息未正确设置
propagate=False，导致父记录器重复处理。 - 异步干扰：在异步环境下，多个协程可能并发调用
log_warning，引发竞争条件。
解决方案
1. 显式配置日志处理器
通过代码强制覆盖uvicorn的默认日志配置：
import logging
from uvicorn.config import LOGGING_CONFIG
LOGGING_CONFIG["handlers"] = {"default": {"class": "logging.StreamHandler"}}
2. 禁用日志传播
为uvicorn的日志器单独设置propagate=False：
logging.getLogger("uvicorn.error").propagate = False
3. 使用过滤器去重
自定义过滤器避免重复记录相同内容：
class DedupFilter(logging.Filter):
def filter(self, record):
current_message = (record.module, record.levelno, record.msg)
if current_message not in self._seen_messages:
self._seen_messages.add(current_message)
return True
return False
高级场景处理
在Docker容器或Kubernetes环境中，还需考虑：
- 日志驱动兼容性（如JSON格式输出）
- 文件轮转策略（使用
RotatingFileHandler）
性能优化建议
高频日志场景下，建议：
- 启用
logging.QueueHandler减少I/O阻塞 - 使用结构化日志工具（如
structlog）提升可读性