返回专栏
专栏 ·

8.4 日志与配置中心:摒弃 print,使用 logging 与 Loguru 构建结构化日志系统

作者: 九路 共 12 章 · 48 小节

欢迎回到 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 架构工匠」 阶段认证勋章!