Ombi项目解决Plex用户导入失败问题指南

在使用Ombi媒体请求平台时，部分用户可能会遇到无法通过内置导入功能添加新Plex用户的问题。本文将深入分析该问题的成因，并提供完整的解决方案。

问题现象分析

当用户尝试通过Ombi的Plex用户导入功能时，系统返回422 Unprocessable Entity错误，具体表现为：

• 控制台显示HTTP状态码为UnprocessableEntity
• 错误指向Plex的账户API端点
• 常规的Plex媒体请求功能仍可正常工作
• 切换Ombi版本无法解决问题

根本原因

该问题的核心在于Plex身份验证令牌过期。Ombi与Plex服务器的连接虽然表面保持，但用于用户管理的API认证凭据已失效，导致无法执行用户列表获取操作。

解决方案

1. 重新认证Plex服务器

   • 进入Ombi管理界面
   • 导航至"设置"→"Plex"选项
   • 移除现有Plex服务器配置
   • 重新添加Plex服务器并完成认证流程

2. 验证解决方案

   • 返回用户管理界面
   • 再次尝试导入Plex用户
   • 确认操作是否成功完成

技术原理

Plex API采用OAuth认证机制，当令牌过期后：

• 基础媒体请求可能仍通过缓存或有限权限工作
• 但用户管理类操作需要完整权限验证
• Ombi的导入功能依赖/users/account.json端点
• 该端点对认证状态要求更为严格

预防措施

为避免类似问题再次发生，建议：

• 定期检查Ombi与Plex的连接状态
• 关注Ombi系统日志中的认证相关警告
• 在Plex密码变更后及时更新Ombi配置
• 考虑设置定期重新认证的维护计划

通过以上步骤，用户可以彻底解决Plex用户导入失败的问题，并确保Ombi与Plex服务的稳定集成。