PlexTraktSync疑难问题排查：10个常见错误及解决方案
【免费下载链接】PlexTraktSyncA python script that syncs the movies, shows and ratings between trakt and Plex (without needing a PlexPass or Trakt VIP subscription)项目地址: https://gitcode.com/gh_mirrors/pl/PlexTraktSync
PlexTraktSync是一款强大的开源工具，能够在Plex媒体服务器和Trakt之间同步电影、剧集和评分，无需PlexPass或Trakt VIP订阅。尽管这款工具设计精良，但用户在使用过程中仍可能遇到各种问题。本文将详细介绍10个最常见的错误及其解决方案，帮助您快速解决同步过程中遇到的困难。
1. Trakt登录失败：ForbiddenException错误
错误表现：尝试登录Trakt时出现"Log in to Trakt failed: ForbiddenException"错误提示。
解决方案：
- 检查您的Trakt账户是否正常，尝试在浏览器中登录Trakt网站确认凭据
- 确保您的应用设置正确：
- 访问Trakt开发者页面创建或编辑应用
- 确保"REDIRECT URL"设置为"urn:ietf:wg:oauth:2.0:oob"
- 重新运行
plextraktsync trakt-login命令
相关代码位置：plextraktsync/commands/trakt_login.py
2. Plex认证失败：Unauthorized错误
错误表现：连接Plex服务器时显示"Unauthorized"或"Log in to Plex failed"错误。
解决方案：
- 验证您的Plex账户凭据是否正确
- 检查Plex服务器是否允许远程访问
- 尝试重新登录Plex：
plextraktsync plex-login - 如果使用令牌认证，确保令牌未过期或被撤销
相关代码位置：plextraktsync/commands/plex_login.py
3. 无法找到Plex服务器
错误表现：登录成功后提示"Unable to find server from Plex account"。
解决方案：
- 确保Plex服务器正在运行且已登录到您的Plex账户
- 检查网络连接，确保服务器和客户端在同一网络
- 尝试手动指定服务器：编辑配置文件添加服务器名称或IP
- 运行
plextraktsync plex-login时选择正确的服务器
相关代码位置：plextraktsync/commands/plex_login.py
4. Trakt令牌刷新失败
错误表现：同步过程中出现"Unable to refresh token"错误。
解决方案：
- 删除现有的Trakt令牌文件：
.pytrakt.json - 清除环境变量中的Trakt凭据
- 重新进行Trakt认证：
plextraktsync trakt-login - 检查系统时间是否正确，令牌过期可能与时间同步有关
相关代码位置：plextraktsync/trakt/TraktApi.py
5. 媒体文件不匹配问题
错误表现：部分媒体无法同步，显示"Nothing to scan"或"Unmatched"提示。
解决方案：
- 检查Plex中的媒体命名是否符合标准
- 确保媒体文件有正确的元数据和ID
- 使用
plextraktsync unmatched命令识别不匹配的项目 - 尝试调整同步配置中的匹配选项
相关代码位置：plextraktsync/commands/unmatched.py
6. HTTP缓存相关错误
错误表现：同步过程中出现HTTP请求错误或缓存相关异常。
解决方案：
- 清除HTTP缓存：
plextraktsync cache clear - 检查缓存配置：
plextraktsync config http_cache - 调整缓存大小限制或过期时间
- 禁用缓存进行测试：修改配置文件中
http_cache.enabled为false
相关代码位置：plextraktsync/commands/cache.py
7. 播放进度同步失败
错误表现：观看进度无法在Plex和Trakt之间同步。
解决方案：
- 检查配置文件中同步选项是否开启：
sync_playback_status: true - 确保Plex媒体项目有正确的GUID和元数据
- 验证Trakt API是否正常工作
- 检查网络连接，确保同步请求能够到达Trakt服务器
相关代码位置：plextraktsync/sync/WatchProgressPlugin.py
8. 权限问题：无法读取或写入配置文件
错误表现：出现文件访问错误或权限被拒绝提示。
解决方案：
- 检查配置文件和缓存文件的权限：
.env和.pytrakt.json - 确保当前用户有足够权限读写应用目录
- 尝试使用管理员权限运行命令：
sudo plextraktsync sync - 验证文件所有者是否正确
相关配置文件：.env,.pytrakt.json,config.yml
9. 字幕下载失败
错误表现：下载字幕时出现"has no key: Not downloadable"或"File doesn't exist"错误。
解决方案：
- 检查Plex服务器是否启用了字幕服务
- 确认媒体文件有可用的字幕
- 尝试手动下载并添加字幕
- 更新PlexTraktSync到最新版本
相关代码位置：plextraktsync/commands/download.py
10. 同步配置冲突
错误表现：同步时没有任何内容被处理，提示"Nothing to scan, this is likely due conflicting options given"。
解决方案：
- 检查同步配置是否正确设置：
plextraktsync config - 确保至少启用了一种媒体类型（电影或电视节目）
- 验证库设置是否正确指向您的Plex库
- 尝试使用默认配置：删除现有配置文件后重新运行
相关代码位置：plextraktsync/plan/WalkPlanner.py
结语
PlexTraktSync是一个功能强大的工具，但遇到问题时不必沮丧。大多数常见问题都可以通过检查配置、更新凭据或清除缓存来解决。如果您遇到本文未涵盖的问题，请查看项目的官方文档或提交issue寻求帮助。
通过正确配置和维护，PlexTraktSync可以无缝地在Plex和Trakt之间同步您的媒体体验，让您的观看记录和评分始终保持最新。
附录：获取帮助的途径
- 查看详细日志：添加
--debug参数运行命令 - 检查配置：
plextraktsync config - 验证登录状态：
plextraktsync login - 项目测试文件：tests/
【免费下载链接】PlexTraktSyncA python script that syncs the movies, shows and ratings between trakt and Plex (without needing a PlexPass or Trakt VIP subscription)项目地址: https://gitcode.com/gh_mirrors/pl/PlexTraktSync
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
