fix(monitor,transfer): 修复 FUSE 挂载无响应导致的监控冻死、整理链锁死与漏件 (#6276)

* wip(v3): 移植监控与整理韧性修复到 v3 基线

包含:监控看门狗隔离/挂载探测、整理队列持久化、文件系统子进程代理、
写入原子化。迁移重挂到 v3 链 8a4c7e1d2f90 -> 7f5c1d2e3a4b -> e3d9f4b7c806。
tmdb 相关测试尚未通过,待定位。

* fix(v3): 修正移植引入的 16 项测试失败

- poller.py:合并时我方保留的行仍用旧变量名 merged_snapshot,而 v3 已统一
  改名为 current_snapshot,导致 NameError 被外层 except 吞掉、快照从未保存
- smb.py:采纳 f-string 拆分写法,恢复 Python 3.11 可解析
- dispatcher 测试:历史查重由 _should_skip_by_history 统一承担,mock 点随之调整
- tmdb 缓存测试:补充 v3 新增的 media_source/media_id 字段
- tmdb 重试测试:为 fake 补充 match_multi/async_match_multi

尚余 3 项与 v3 识别流程的连接失败处理有关,待单独判断。

* fix(v3): 测试适配 v3 的 media_source/media_id 重构

v3 将媒体标识从 tmdbid 统一重构为 media_source + media_id,recognize_media
的 tmdbid 参数已被 **kwargs 静默吞掉——传了也不生效,流程会误降级到名称搜索。
tmdb 重试用例改用新参数后恢复正确路径。

同时修正 fake 的 match_multi 语义:真实实现(tmdbapi.match_multi)吞掉所有
异常并返回 None,连接失败与「未找到」在该路径上本就不可区分,fake 需保持一致。

至此移植引入的 19 项失败全部清零。

---------

Co-authored-by: Aqr-K <Aqr-K@users.noreply.github.com>
This commit is contained in:
Aqr-K
2026-08-13 08:19:54 +08:00
committed by GitHub
co-authored by Aqr-K
parent 4d11a38496
commit a2e70b443d
62 changed files with 7889 additions and 360 deletions
+41 -1
View File
@@ -3,6 +3,7 @@ import traceback
from math import ceil
from threading import RLock
from time import time
from typing import Any
from app.core.cache import FileCache, TTLCache
from app.core.config import settings
@@ -144,6 +145,30 @@ class TmdbCache(metaclass=WeakSingleton):
media_id = meta.media_id if meta.media_source == MediaSource.TMDB else None
return f"[{meta.type.value if meta.type else '未知'}][{settings.TMDB_LOCALE}]{media_id or meta.name}-{meta.year}-{meta.begin_season}"
@staticmethod
def __is_type_conflicted(meta: MetaBase, media_type: Any, tmdb_id: Any) -> bool:
"""
判断媒体类型是否与元数据声明的类型冲突。
只有「元数据判定为电视剧、结果却是电影」才算冲突。反向不算:名称识别在
电影分支查不到时会回退到电视剧查询,识别缓存正是用来记住这个纠正结果,
一律要求 key 与 value 类型一致会让这类条目每次都被丢弃、反复回源。而电视
剧分支恒定写入电视剧类型,`[电视剧]` 键下出现电影只可能来自 tmdbid 消歧
或共享识别回填的脏写,会让整季剧集被当成电影反复整理失败。
:param meta: 元数据
:param media_type: 待校验的媒体类型
:param tmdb_id: 对应的 TMDB ID,为空表示负缓存,不带类型信息
:return: 是否冲突
"""
if meta.type != MediaType.TV or not tmdb_id:
return False
if not isinstance(media_type, MediaType):
try:
media_type = MediaType(media_type)
except (TypeError, ValueError):
return False
return media_type == MediaType.MOVIE
def get(self, meta: MetaBase):
"""
根据KEY值获取缓存值
@@ -154,7 +179,17 @@ class TmdbCache(metaclass=WeakSingleton):
cache_data = self._cache.get(key)
if not cache_data and self._expires_at.pop(key, None) is not None:
self._dirty = True
return cache_data or {}
if not cache_data or not isinstance(cache_data, dict):
return {}
if self.__is_type_conflicted(meta, cache_data.get("type"), cache_data.get("id")):
# 脏条目不丢弃就会被无限期沿用,正确的识别逻辑永远没有执行机会
logger.warn(f"识别缓存类型与元数据冲突,已丢弃并重新识别:{key} -> "
f"{cache_data.get('title')}({cache_data.get('type')})")
self._cache.delete(key)
self._expires_at.pop(key, None)
self._dirty = True
return {}
return cache_data
def delete(self, key: str) -> dict:
"""
@@ -193,6 +228,11 @@ class TmdbCache(metaclass=WeakSingleton):
"""
key = self.__get_key(meta)
if info:
if self.__is_type_conflicted(meta, info.get("media_type"), info.get("id")):
# 拒绝写入而不是改写键:识别结果照常返回,只是不把矛盾条目留给下一次
logger.warn(f"识别结果类型与元数据冲突,不写入识别缓存:{key} -> "
f"{info.get('title')}({info.get('media_type')})")
return
# 缓存标题
cache_title = info.get("title") \
if info.get("media_type") == MediaType.MOVIE else info.get("name")