4.8 KiB

Raw Blame History

Changelog: 日志系统迁移 - 阶段 4（任务层）

日期: 2026-01-29
类型: 重构
影响范围: 任务层（5个文件）
关联: RFC 201

变更概述

完成日志系统迁移的阶段 4，将 5 个 Celery 任务文件从 loguru 迁移到 Python 标准库 logging。

迁移文件清单

1. tasks/ai_tasks.py

日志调用数: 12 处
任务类型: AI 生成任务（图片、视频、配音）
变更内容:
- 导入: from loguru import logger → from app.core.logging import get_logger
- 初始化: 添加 logger = get_logger(__name__)
- 所有日志调用改用 %-formatting
- 错误日志添加 exc_info=True
- 保持中文日志消息

2. tasks/export_tasks.py

日志调用数: 12 处
任务类型: 导出任务（项目导出、视频渲染、缩略图生成）
变更内容:
- 导入: from loguru import logger → from app.core.logging import get_logger
- 初始化: 添加 logger = get_logger(__name__)
- 所有日志调用改用 %-formatting
- 错误日志添加 exc_info=True
- 保持中文日志消息

3. tasks/maintenance_tasks.py

日志调用数: 9 处
任务类型: 维护任务（清理过期数据、统计）
变更内容:
- 导入: from loguru import logger → from app.core.logging import get_logger
- 初始化: 添加 logger = get_logger(__name__)
- 所有日志调用改用 %-formatting
- 错误日志添加 exc_info=True
- 保持中文日志消息

4. tasks/recharge_tasks.py

日志调用数: 8 处
任务类型: 充值定时任务（订单超时处理、孤儿订单检查）
变更内容:
- 导入: from loguru import logger → from app.core.logging import get_logger
- 初始化: 添加 logger = get_logger(__name__)
- 所有日志调用改用 %-formatting
- 保持中文日志消息

5. tasks/sms_tasks.py

日志调用数: 3 处
任务类型: 短信定时任务（清理过期验证码）
变更内容:
- 导入: from loguru import logger → from app.core.logging import get_logger
- 初始化: 添加 logger = get_logger(__name__)
- 所有日志调用改用 %-formatting
- 保持中文日志消息

技术细节

Celery 任务日志示例

Before (loguru):

logger.info(f"开始生成图片，任务 ID: {self.request.id}")
logger.info(f"Prompt: {prompt}, Model: {model}")
logger.error(f"图片生成失败，任务 ID: {self.request.id}, 错误: {str(e)}")

After (标准库 logging):

logger.info("开始生成图片，任务 ID: %s", self.request.id)
logger.info("Prompt: %s, Model: %s", prompt, model)
logger.error("图片生成失败，任务 ID: %s", self.request.id, exc_info=True)

关键改进

任务追踪: 所有任务日志包含 task_id，便于追踪
异常处理: 错误日志添加完整堆栈跟踪
中文消息: 保持中文日志，便于运维人员理解任务状态
模块级 logger: 使用 __name__ 自动获取任务模块路径

验证结果

语法检查

✅ tasks/ai_tasks.py - No diagnostics found
✅ tasks/export_tasks.py - No diagnostics found
✅ tasks/maintenance_tasks.py - No diagnostics found
✅ tasks/recharge_tasks.py - No diagnostics found
✅ tasks/sms_tasks.py - No diagnostics found

残留 loguru 引用

$ rg "from loguru import logger" --type py
# 剩余 5 个文件（符合预期：10 - 5 = 5）
# 全部为迁移脚本文件

影响评估

功能影响

✅ 无功能变更
✅ Celery 任务执行正常
✅ 任务日志完整记录
✅ 异常堆栈完整

性能影响

标准库 logging 性能略优于 loguru
Celery 任务日志开销降低

后续步骤

阶段 5: 迁移脚本（5 个文件）- 最后阶段

app/migrations/001_uuid_migration.py
app/migrations/002_folder_enhancement.py
app/migrations/003_project_tables.py
app/migrations/010_recharge_service_tables.py
app/migrations/011_sms_service_tables.py

阶段 6: 清理验证

移除 requirements.txt 中的 loguru==0.7.2
全局验证无残留引用
运行完整测试套件
更新相关文档

团队协作

执行人: AI Assistant
审核人: 待指定
测试人: 待指定
预计完成时间: 2026-01-29（已完成）

状态: ✅ 已完成
验证: ✅ 通过
文档: ✅ 已更新
进度: 18/23 文件 (78%)

4.8 KiB Raw Blame History