Ombi项目中的Plex用户导入问题分析与解决方案

问题背景

在Ombi 4.43.10版本中，用户报告了一个关于Plex用户导入的异常现象：系统会导入一些实际上已经不存在于Plex服务器中的用户账号。这些用户曾经存在但已被移除，然而Ombi仍然会持续导入这些"幽灵"用户。具体表现为：

• Plex服务器当前仅与12个用户共享库
• 但Ombi导入后显示16个用户
• 手动删除后再次导入，这些用户仍会被重新添加
• 这些"多余"用户已确认不在Plex服务器的"账户库访问"或"我的好友"列表中

技术分析

经过深入调查，发现问题根源在于Ombi与Plex API的交互方式。Ombi通过调用Plex API获取用户列表时，Plex会返回所有曾经关联过的用户，而不仅仅是当前有访问权限的用户。

关键发现：

1. 通过直接调用Plex API接口，可以确认这些"幽灵"用户确实存在于API返回的XML数据中
2. 这些用户账号在XML结构中缺少<Server>元素，表明他们已不再拥有服务器访问权限
3. 当前Ombi版本没有对用户访问权限状态进行验证，导致导入所有返回的用户

解决方案

Ombi开发团队在4.47.2版本中修复了此问题，实现逻辑如下：

1. 解析Plex API返回的XML用户列表时，增加对<Server>元素的检查
2. 只有当用户包含至少一个<Server>元素时，才视为有效用户进行导入
3. 对于没有<Server>元素的用户，自动排除不导入

示例XML结构对比：

<!-- 有效用户(包含Server元素) -->
<User id="123" ...>
    <Server id="1" serverId="1" ... />
</User>

<!-- 无效用户(无Server元素) -->
<User id="456" ...>
</User>

临时解决方案

在修复版本发布前，用户可以采用以下临时方案：

1. 在Ombi的"用户导入设置"中，手动将这些"幽灵"用户添加到"Plex用户排除列表"
2. 确保"清理Plex用户"选项已启用，以保持用户列表整洁

技术建议

对于类似集成系统的开发，建议：

1. 第三方API返回的数据需要谨慎处理，不能完全信任
2. 关键业务逻辑应增加额外的验证层
3. 对于用户/权限类数据，应检查其实际有效性而不仅是存在性
4. 考虑实现缓存机制，减少对API的频繁调用

总结

这一问题展示了系统集成中常见的"数据理解不一致"问题。通过深入分析API返回数据结构和业务需求，开发团队找到了合理的解决方案。升级到最新版本Ombi后，用户导入功能将能正确识别并过滤无访问权限的Plex用户，保持用户列表的准确性。