8.4 日志与配置中心:摒弃 print,使用 logging 与 Loguru 构建结构化日志系统
本节目录
欢迎回到 HelloWorld 技术社区(www.helloworld.net) 《Python 现代开发实战》第 8 章(第二阶段中级篇)收官之作!
生产环境排障的最大噩梦,就是代码里全是用 print() 输出的无时间戳、无级别、无上下文的裸文本,一旦进容器后台就再也捞不着。
1. 现代开发者的宠儿:Loguru 开箱即用结构化日志
from loguru import logger
# 配置自动按天轮转、压缩归档、保留 14 天的 JSON 结构化日志文件(方便 ELK/Loki 采集)
logger.add(
"logs/hw_service_{time:YYYY-MM-DD}.log",
rotation="00:00",
retention="14 days",
compression="zip",
serialize=True, # 输出标准 JSON 格式日志
level="INFO",
)
# 绑定请求追踪上下文(Trace ID),整条调用链自动携带该字段
req_logger = logger.bind(trace_id="req-9527", user_id=1001)
req_logger.info("用户发起专栏订阅请求")
2. 配置管理铁律:环境变量 + pydantic-settings
严禁把数据库密码、JWT 密钥和 API Key 硬编码进 Git 仓库! 使用 pydantic-settings 自动从 .env 文件和操作系统环境变量加载并校验配置:
from pydantic_settings import BaseSettings, SettingsConfigDict
class AppSettings(BaseSettings):
model_config = SettingsConfigDict(env_file=".env", env_prefix="HW_")
debug: bool = False
database_url: str
redis_url: str = "redis://localhost:6379/0"
🏆 第二阶段结业综合挑战
恭喜你通关《Python 现代开发实战》第二阶段(第 5–8 章,共 16 节)!
第二阶段结业任务:结合 @dataclass / Pydantic + 自定义装饰器 + pytest,编写一个带内存缓存与耗时监控的“社区热榜计算服务”,并编写至少 3 个 pytest 测试用例验证缓存命中与边界异常。带 #Python专栏打卡 发到评论区,解锁 「Pythonic 架构工匠」 阶段认证勋章!