MoviePilot项目TMDB连接问题的诊断与解决方案

问题背景

近期在MoviePilot项目（版本2.2.7.2至2.2.8.1）中，部分用户遇到了无法连接TheMovieDB(TMDB)的问题，导致视频无法正常整理入库。该问题表现为程序日志中频繁出现"无法连接TheMovieDb，请检查网络连接"的错误提示。

问题现象分析

当用户升级到2.2.7.2及之后的版本时，系统会出现以下典型症状：

1. 程序日志中持续报错"连接TMDB出错：无法连接TheMovieDb"
2. 视频整理和元数据刮削功能失效
3. 回退到2.2.7.1版本则功能恢复正常

根本原因

经过开发团队的分析确认，此问题源于项目在2.2.7.2版本中引入的一项网络连接相关变更：将DOH_ENABLE（DNS over HTTPS）的默认值设置为false。这一改动影响了部分网络环境下的DNS解析能力，特别是当用户处于某些特殊的网络配置环境下时。

解决方案

方法一：通过环境变量配置

对于使用Docker部署的用户，可以在容器环境变量中添加以下配置：

environment:
  - DOH_ENABLE=true

方法二：通过高级设置配置（适用于v2版本）

1. 进入MoviePilot的系统设置
2. 找到"高级设置"选项
3. 在"网络"设置部分
4. 启用"DNS Over https"选项

技术原理说明

DNS over HTTPS(DoH)是一种通过HTTPS协议进行DNS查询的隐私保护技术。在MoviePilot项目中：

1. 启用DoH可以绕过某些网络环境中的DNS解析异常或限制
2. 当DoH被禁用时，程序会使用系统默认的DNS解析方式
3. 在某些网络环境下，传统DNS解析可能无法正确解析TMDB的域名

预防措施

为避免类似问题影响使用体验，建议用户：

1. 在升级前检查版本变更日志
2. 保持对项目设置的备份
3. 了解自己网络环境的特点和限制

总结

MoviePilot项目在2.2.7.2版本中引入的DNS解析方式变更，虽然提升了部分场景下的兼容性，但也导致了一些特殊网络环境下TMDB连接问题。通过合理配置DNS over HTTPS选项，用户可以恢复正常的视频整理功能。这体现了在软件开发中网络连接配置的重要性，以及为不同网络环境提供灵活配置选项的必要性。