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
+53 -15
View File
@@ -8,7 +8,7 @@ from app.schemas.types import MediaType
from app.utils.string import StringUtils
from app.utils.zhconv import convert as zhconv_convert
from .tmdbv3api import TMDb, Search, Movie, TV, Season, Episode, Discover, Trending, Person, Collection
from .tmdbv3api.exceptions import TMDbException
from .tmdbv3api.exceptions import TMDbException, TMDbConnectionError
class TmdbApi:
@@ -584,11 +584,14 @@ class TmdbApi:
def get_info(self,
mtype: MediaType,
tmdbid: int) -> dict:
tmdbid: int,
raise_on_connection_error: bool = False) -> dict:
"""
给定TMDB号,查询一条媒体信息
:param mtype: 类型:电影、电视剧,为空时都查(此时用不上年份)
:param tmdbid: TMDB的ID,有tmdbid时优先使用tmdbid,否则使用年份和标题
:param raise_on_connection_error: 为True时,遇到TMDB连接失败(区别于404等业务错误)
将抛出TMDbConnectionError而不是吞掉返回None;默认False,与既有调用方行为完全一致
"""
def __get_genre_ids(genres: list) -> list:
@@ -604,16 +607,16 @@ class TmdbApi:
# 查询TMDB详情
if mtype == MediaType.MOVIE:
tmdb_info = self.__get_movie_detail(tmdbid)
tmdb_info = self.__get_movie_detail(tmdbid, raise_on_connection_error=raise_on_connection_error)
if tmdb_info:
tmdb_info['media_type'] = MediaType.MOVIE
elif mtype == MediaType.TV:
tmdb_info = self.__get_tv_detail(tmdbid)
tmdb_info = self.__get_tv_detail(tmdbid, raise_on_connection_error=raise_on_connection_error)
if tmdb_info:
tmdb_info['media_type'] = MediaType.TV
else:
tmdb_info_tv = self.__get_tv_detail(tmdbid)
tmdb_info_movie = self.__get_movie_detail(tmdbid)
tmdb_info_tv = self.__get_tv_detail(tmdbid, raise_on_connection_error=raise_on_connection_error)
tmdb_info_movie = self.__get_movie_detail(tmdbid, raise_on_connection_error=raise_on_connection_error)
if tmdb_info_tv and tmdb_info_movie:
tmdb_info = None
logger.warn(f"无法判断tmdb_id:{tmdbid} 是电影还是电视剧")
@@ -797,10 +800,13 @@ class TmdbApi:
"alternative_titles,"
"translations,"
"release_dates,"
"external_ids") -> Optional[dict]:
"external_ids",
raise_on_connection_error: bool = False) -> Optional[dict]:
"""
获取电影的详情
:param tmdbid: TMDB ID
:param raise_on_connection_error: 为True时TMDB连接失败会抛出TMDbConnectionError
而不是像默认那样吞掉返回None;404等TMDB业务错误不受影响,始终返回None
:return: TMDB信息
"""
"""
@@ -899,6 +905,11 @@ class TmdbApi:
if tmdbinfo:
logger.debug(f"{tmdbid} 查询结果:{tmdbinfo.get('title')}")
return tmdbinfo or {}
except TMDbConnectionError as err:
logger.error(str(err))
if raise_on_connection_error:
raise
return None
except Exception as e:
logger.error(str(e))
return None
@@ -911,10 +922,13 @@ class TmdbApi:
"translations,"
"content_ratings,"
"external_ids,"
"episode_groups") -> Optional[dict]:
"episode_groups",
raise_on_connection_error: bool = False) -> Optional[dict]:
"""
获取电视剧的详情
:param tmdbid: TMDB ID
:param raise_on_connection_error: 为True时TMDB连接失败会抛出TMDbConnectionError
而不是像默认那样吞掉返回None;404等TMDB业务错误不受影响,始终返回None
:return: TMDB信息
"""
"""
@@ -1084,6 +1098,11 @@ class TmdbApi:
if tmdbinfo:
logger.debug(f"{tmdbid} 查询结果:{tmdbinfo.get('name')}")
return tmdbinfo or {}
except TMDbConnectionError as err:
logger.error(str(err))
if raise_on_connection_error:
raise
return None
except Exception as e:
logger.error(str(e))
return None
@@ -1666,10 +1685,13 @@ class TmdbApi:
"alternative_titles,"
"translations,"
"release_dates,"
"external_ids") -> Optional[dict]:
"external_ids",
raise_on_connection_error: bool = False) -> Optional[dict]:
"""
获取电影的详情(异步版本)
:param tmdbid: TMDB ID
:param raise_on_connection_error: 为True时TMDB连接失败会抛出TMDbConnectionError
而不是像默认那样吞掉返回None;404等TMDB业务错误不受影响,始终返回None
:return: TMDB信息
"""
if not self.movie:
@@ -1680,6 +1702,11 @@ class TmdbApi:
if tmdbinfo:
logger.debug(f"{tmdbid} 查询结果:{tmdbinfo.get('title')}")
return tmdbinfo or {}
except TMDbConnectionError as err:
logger.error(str(err))
if raise_on_connection_error:
raise
return None
except Exception as e:
logger.error(str(e))
return None
@@ -1692,10 +1719,13 @@ class TmdbApi:
"translations,"
"content_ratings,"
"external_ids,"
"episode_groups") -> Optional[dict]:
"episode_groups",
raise_on_connection_error: bool = False) -> Optional[dict]:
"""
获取电视剧的详情(异步版本)
:param tmdbid: TMDB ID
:param raise_on_connection_error: 为True时TMDB连接失败会抛出TMDbConnectionError
而不是像默认那样吞掉返回None;404等TMDB业务错误不受影响,始终返回None
:return: TMDB信息
"""
if not self.tv:
@@ -1706,6 +1736,11 @@ class TmdbApi:
if tmdbinfo:
logger.debug(f"{tmdbid} 查询结果:{tmdbinfo.get('name')}")
return tmdbinfo or {}
except TMDbConnectionError as err:
logger.error(str(err))
if raise_on_connection_error:
raise
return None
except Exception as e:
logger.error(str(e))
return None
@@ -1922,11 +1957,14 @@ class TmdbApi:
async def async_get_info(self,
mtype: MediaType,
tmdbid: int) -> dict:
tmdbid: int,
raise_on_connection_error: bool = False) -> dict:
"""
给定TMDB号,查询一条媒体信息(异步版本)
:param mtype: 类型:电影、电视剧,为空时都查(此时用不上年份)
:param tmdbid: TMDB的ID,有tmdbid时优先使用tmdbid,否则使用年份和标题
:param raise_on_connection_error: 为True时,遇到TMDB连接失败(区别于404等业务错误)
将抛出TMDbConnectionError而不是吞掉返回None;默认False,与既有调用方行为完全一致
"""
def __get_genre_ids(genres: list) -> list:
@@ -1942,16 +1980,16 @@ class TmdbApi:
# 查询TMDB详情
if mtype == MediaType.MOVIE:
tmdb_info = await self.__async_get_movie_detail(tmdbid)
tmdb_info = await self.__async_get_movie_detail(tmdbid, raise_on_connection_error=raise_on_connection_error)
if tmdb_info:
tmdb_info['media_type'] = MediaType.MOVIE
elif mtype == MediaType.TV:
tmdb_info = await self.__async_get_tv_detail(tmdbid)
tmdb_info = await self.__async_get_tv_detail(tmdbid, raise_on_connection_error=raise_on_connection_error)
if tmdb_info:
tmdb_info['media_type'] = MediaType.TV
else:
tmdb_info_tv = await self.__async_get_tv_detail(tmdbid)
tmdb_info_movie = await self.__async_get_movie_detail(tmdbid)
tmdb_info_tv = await self.__async_get_tv_detail(tmdbid, raise_on_connection_error=raise_on_connection_error)
tmdb_info_movie = await self.__async_get_movie_detail(tmdbid, raise_on_connection_error=raise_on_connection_error)
if tmdb_info_tv and tmdb_info_movie:
tmdb_info = None
logger.warn(f"无法判断tmdb_id:{tmdbid} 是电影还是电视剧")