ocr_platform/ticket_template_lite.md

BUG工单: timing_service中未定义os

创建时间: YYYY-MM-DD 工单编号: TKT-YYYYMMDD-NNN 优先级: P3 状态: 处理中

---

📋 阶段进度

LITE 工单（P3 / 优化项 / 5 分钟内可解决）— Phase 0~7

Phase	名称	状态	执行者	完成时间
0	开单	✅	agent	YYYY-MM-DD
1	根因分析	✅	agent	YYYY-MM-DD
2	brainstorming	✅	agent	YYYY-MM-DD
3	写计划	🔄	agent	-
4	执行修复	🔄	-	-
5	验证	🔄	-	-
6	经验教训	🔄	-	-
7	更新文档	🔄	-	-

---

问题描述 / 需求描述

执行 bash ocrtrl.sh restart 后，日志报错：Page preprocessing failed, using original copy: name 'os' is not defined、Layout detection failed: name 'os' is not defined 等，导致 OCR 全功能失效。

影响范围

项目	说明
影响页面	OCR 识别页面
影响组件	timing_service.py
影响功能	耗时统计与核心 OCR 流水线
当前状态	功能不可用

---

复现步骤（BUG）/ 功能需求（特性）

BUG：复现步骤

1. 启动服务：bash ocrtrl.sh restart
2. 提交一笔 OCR 任务。
3. 预期：任务正常识别，时间统计正常。
4. 实际：日志报 name 'os' is not defined，识别结果全部为空。

---

环境信息

• 后端服务：ocr-server / ocr-platform

---

根因分析（BUG）

BUG：根因分析

代码定位

• 文件：src/shared/time_stats/timing_service.py
• 行号：101
• 函数：timing_wrapper

问题分析

在 timing_service.py 中，timing_wrapper 访问了 os.environ，但是在文件头部没有 import os，导致 NameError: name 'os' is not defined。

[根因一句话总结] 在 timing_service.py 中，使用 os.environ 前未导入 os 模块。

---

修复方案

在 src/shared/time_stats/timing_service.py 头部添加 import os。

---

验证结果

• 单元测试：待执行
• 集成测试：待执行