fix(test): hevc 转码测试彻底移除 video_processing sys.modules mock 注入（39 用例跨文件污染修复） #1568

Merged

xiaoxia merged 5 commits from fix/test-hevc-mock-no-sysmodules into develop 2026-08-31 11:26:42 +08:00

Conversation 5 Commits 5 Files Changed 1

+14 -27

xiaoxia commented 2026-08-31 09:04:24 +08:00

Owner

Copy Link

Copy Source

背景

PR #1567 v3 修复后，CI Unit Tests 仍有 39 个用例失败（run 42831/42832）。根因：test_ingest_hevc_transcode_task.py 模块级向 sys.modules 注入 video_processing.oss_helpers / video_processing.thumbnail_generator 的 MagicMock，即使清理也因 video_processing/__init__.py 的 from . import oss_helpers 导致包属性残留，跨文件污染：

受害者文件	失败数	症状
test_oss_helpers_pure.py	~10	normalize_storage_key() 返回 MagicMock
test_oss_upload_crash_fix.py	~7	oss_bucket() 返回 MagicMock
test_p02_worker_oss_fix.py	~10	oss_bucket() / upload_to_oss() 返回 MagicMock
test_ingest_hevc_transcode_task.py	2	upload_to_oss mock called 0 times

修复

彻底不再向 sys.modules 注入 video_processing.* mock：

1. 删除 sys.modules["video_processing.oss_helpers"] = MagicMock() 和 thumbnail_generator 同款
2. 模块级直接 from video_processing import oss_helpers as _oss_helpers_real（CI 环境有 oss2 / requests 等依赖）
3. _start_patches() 中 patch.object(_oss_helpers_real, "upload_to_oss", ...) 打在真实模块属性上
4. thumb patcher 从字符串目标 patch("video_processing.thumbnail_generator.extract_first_frame", ...) 改为 patch.object(_thumb_gen_real, "extract_first_frame", ...)
5. worker_app.db / worker_app.celery_app mock 保留（独立包树，不影响共享工具包）

影响面

• 纯测试文件改动，不碰业务代码
• worker_app mock 泄漏保护不变
• patch.object().stop() 自动还原模块属性，零跨文件副作用

🤖 Generated by [构建服务器运维] agent

## 背景 PR #1567 v3 修复后，CI Unit Tests 仍有 39 个用例失败（run 42831/42832）。根因：`test_ingest_hevc_transcode_task.py` 模块级向 `sys.modules` 注入 `video_processing.oss_helpers` / `video_processing.thumbnail_generator` 的 MagicMock，即使清理也因 `video_processing/__init__.py` 的 `from . import oss_helpers` 导致包属性残留，跨文件污染： | 受害者文件 | 失败数 | 症状 | |---|---|---| | test_oss_helpers_pure.py | ~10 | `normalize_storage_key()` 返回 MagicMock | | test_oss_upload_crash_fix.py | ~7 | `oss_bucket()` 返回 MagicMock | | test_p02_worker_oss_fix.py | ~10 | `oss_bucket()` / `upload_to_oss()` 返回 MagicMock | | test_ingest_hevc_transcode_task.py | 2 | `upload_to_oss` mock called 0 times | ## 修复 **彻底不再向 `sys.modules` 注入 `video_processing.*` mock**： 1. 删除 `sys.modules["video_processing.oss_helpers"] = MagicMock()` 和 `thumbnail_generator` 同款 2. 模块级直接 `from video_processing import oss_helpers as _oss_helpers_real`（CI 环境有 oss2 / requests 等依赖） 3. `_start_patches()` 中 `patch.object(_oss_helpers_real, "upload_to_oss", ...)` 打在真实模块属性上 4. thumb patcher 从字符串目标 `patch("video_processing.thumbnail_generator.extract_first_frame", ...)` 改为 `patch.object(_thumb_gen_real, "extract_first_frame", ...)` 5. `worker_app.db` / `worker_app.celery_app` mock 保留（独立包树，不影响共享工具包） ## 影响面 - 纯测试文件改动，不碰业务代码 - worker_app mock 泄漏保护不变 - `patch.object().stop()` 自动还原模块属性，零跨文件副作用 🤖 Generated by [构建服务器运维] agent

xiaoxia added 1 commit 2026-08-31 09:04:24 +08:00

fix(test): hevc 转码测试不再注入 video_processing mock 到 sys.modules ... e5d7fddfcf

根因：sys.modules 注入 video_processing.oss_helpers / thumbnail_generator 的
MagicMock 即使清理，仍因 video_processing/__init__.py 的
`from . import oss_helpers` 导致包属性残留为 MagicMock，
跨文件污染 test_oss_helpers_pure / test_oss_upload_crash_fix /
test_p02_worker_oss_fix 等（39 个用例失败）。

修复：不再向 sys.modules 注入 video_processing.* mock，改为直接
import 真实模块后用 patch.object 打补丁（patch.stop 自动还原）。
worker_app.db / celery_app mock 保留（独立包树，不影响共享工具包）。

gitea-actions bot commented 2026-08-31 09:09:22 +08:00

Copy Link

Copy Source

🚀 预览环境已部署

项目	详情
PR号	#1568
预览链接	https://pr-1568.preview.xiaoxiajianji.com
API环境	staging

💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。

🔄 每次提交新代码后预览环境会自动更新。

🗑️ PR 关闭或合并后，预览环境会自动清理。

🚀 **预览环境已部署** | 项目 | 详情 | |------|------| | PR号 | #1568 | | 预览链接 | [https://pr-1568.preview.xiaoxiajianji.com](https://pr-1568.preview.xiaoxiajianji.com) | | API环境 | staging | > 💡 预览环境使用 staging API 数据，请勿在预览环境中操作重要数据。 > > 🔄 每次提交新代码后预览环境会自动更新。 > > 🗑️ PR 关闭或合并后，预览环境会自动清理。

auto-approve-bot added 1 commit 2026-08-31 09:11:46 +08:00

style: auto-format with black + isort + prettier [skip ci-format-check] 26856e1015

auto-approve-bot approved these changes 2026-08-31 09:20:32 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

auto-approve-bot approved these changes 2026-08-31 09:20:32 +08:00

auto-approve-bot left a comment

Collaborator

Copy Link

Copy Source

CI全绿，自动审批通过。

CI全绿，自动审批通过。

xiaoxia added 1 commit 2026-08-31 09:23:19 +08:00

fix(test): thumb patcher 改回字符串目标 ... 2662cd78fe

patch.object(_thumb_gen_real) 对 ingest.py 的局部 import 不生效
（模块对象可能不同），改回 patch(字符串目标) 从 sys.modules 取真实模块打补丁。
核心修复（不注入 video_processing mock 到 sys.modules）不变。

xiaoxia added 1 commit 2026-08-31 10:58:00 +08:00

fix(test): upload_to_oss patcher 改用字符串目标，修复 ingest.py 局部 import 不生效 ... 8d8b565499

patch.object(_oss_helpers_real, ...) 对 ingest.py 函数体内的
from video_processing.oss_helpers import upload_to_oss 不生效，
改为 patch("video_processing.oss_helpers.upload_to_oss", ...)
与 thumb patcher 策略一致，确保 patch.start() 时从 sys.modules
解析模块对象再打补丁。

xiaoxia added 1 commit 2026-08-31 11:11:45 +08:00

fix(test): 清理 sys.modules 时保留 video_processing.* 模块 ... 301b591037

清理逻辑跳过 video_processing.* 前缀的模块，确保 patch() 字符串
目标解析到的模块对象与 ingest_mod 内部引用的一致，避免 mock 失效。
修复 AI Code Review 阻塞级问题。

auto-approve-bot commented 2026-08-31 11:16:00 +08:00

Collaborator

Copy Link

Copy Source

【阻塞级判定】

• 是否存在阻塞级问题：否
• 阻塞级问题数量：0 个

📊 审查概览

• 整体评价：通过
• 建议级问题数量：0 个

🔴 阻塞级问题（必须修复）

无

💡 改进建议（不阻塞合并）

无

✅ 良好实践

1. 修复测试隔离问题：PR 正确识别并修复了 sys.modules 注入 Mock 导致的跨文件污染问题。通过移除对 video_processing 的 Mock 注入，改为导入真实模块并在测试时进行 patch，有效避免了因 __init__.py 导入机制导致的包属性残留为 MagicMock 的现象。
2. 清理逻辑优化：修改后的 sys.modules 清理逻辑（跳过 video_processing）与新的导入策略（保留真实模块）保持一致，逻辑自洽，确保了测试环境在执行前后状态的预期行为。
3. 注释清晰：代码注释详细解释了修改原因（避免 MagicMock 污染）以及实现细节（时序冲突、跨文件影响），有助于后续维护。

---

✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能无明显问题

---

_{🤖 由 AI 代码审查机器人自动生成 | 2026-08-31 03:16:00 | 模型:}

### 【阻塞级判定】 - 是否存在阻塞级问题：否 - 阻塞级问题数量：0 个 ### 📊 审查概览 - 整体评价：通过 - 建议级问题数量：0 个 ### 🔴 阻塞级问题（必须修复） 无 ### 💡 改进建议（不阻塞合并） 无 ### ✅ 良好实践 1. **修复测试隔离问题**：PR 正确识别并修复了 `sys.modules` 注入 Mock 导致的跨文件污染问题。通过移除对 `video_processing` 的 Mock 注入，改为导入真实模块并在测试时进行 patch，有效避免了因 `__init__.py` 导入机制导致的包属性残留为 `MagicMock` 的现象。 2. **清理逻辑优化**：修改后的 `sys.modules` 清理逻辑（跳过 `video_processing`）与新的导入策略（保留真实模块）保持一致，逻辑自洽，确保了测试环境在执行前后状态的预期行为。 3. **注释清晰**：代码注释详细解释了修改原因（避免 MagicMock 污染）以及实现细节（时序冲突、跨文件影响），有助于后续维护。 --- ✅ 格式检查通过 | ✅ 逻辑审查通过 | ✅ 性能无明显问题 --- _{🤖 由 AI 代码审查机器人自动生成 | 2026-08-31 03:16:00 | 模型:} <!-- AI_CODE_REVIEW_AUTO_COMMENT -->

xiaoxia merged commit 301b591037 into develop 2026-08-31 11:26:42 +08:00

gitea-actions bot commented 2026-08-31 11:30:58 +08:00

Copy Link

Copy Source

🗑️ 预览环境已清理

PR #1568 已关闭或合并，对应的预览环境已被清理。

如有需要，可以重新打开 PR 来重新生成预览环境。

🗑️ **预览环境已清理** PR #1568 已关闭或合并，对应的预览环境已被清理。 > 如有需要，可以重新打开 PR 来重新生成预览环境。

Sign in to join this conversation.

Reviewers

No Reviewers

auto-approve-bot

Labels

Clear labels

P0

阻塞性，必须立即处理

P1

高优先级

P2

中优先级

P3

低优先级/后考虑

architecture

架构设计

backend

后端相关

blocked

阻塞中

bug

Bug修复

ci-bug

CI本身的bug

ci-optimization

CI优化类任务

ci-pipeline

CI流水线/workflow相关

cleanup

代码清理

devops

运维/部署/CI

documentation

文档相关

feature

新功能

frontend

前端相关

question

需要讨论确认

ready

PR CI通过，可合并

refactor

代码重构

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

auto-approve-bot xiaoxia

No Assignees

3 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: xiaoxia/xiaoxia-saas#1568