MoviePilot项目中的115网盘刮削风控问题分析

背景概述

在MoviePilot项目2.3.5-1版本中，用户报告了一个关于115网盘刮削功能的重要问题：当尝试从115网盘的一个文件夹移动文件到另一个文件夹时，系统会触发115网盘的风控机制，导致操作失败。值得注意的是，手动逐集刮削操作可以正常进行，但批量自动化操作则会受到限制。

问题现象

从系统日志中可以清晰地看到以下关键错误信息：

1. 多次出现"GET请求/open/ufile/files出错：None！"的警告
2. "已达到当前访问上限，请稍后再试"的错误提示
3. 目录创建失败："【u115】/mam/tv/欧美剧/黄石 (2018)/Season 4目录获取失败"
4. 文件整理失败："黄石 S04E06.mkv入库失败"

这些错误表明115网盘对频繁的API请求实施了访问限制，当MoviePilot尝试批量操作时，触发了这个保护机制。

技术分析

115网盘API限制机制

115网盘对API调用设有严格的频率限制，特别是对于以下操作：

• 文件列表获取(/open/ufile/files)
• 目录创建(/open/folder/add)
• 上传初始化(/open/upload/init)

当短时间内发起大量请求时，115服务器会返回"已达到当前访问上限"的错误，并暂时阻止后续请求。

MoviePilot的刮削流程

从日志可以看出MoviePilot的典型刮削流程：

1. 识别媒体文件(如"黄石 S04E06.mkv")
2. 查询TMDB获取元数据
3. 在目标位置创建目录结构
4. 移动文件并生成配套的nfo和图片文件
5. 更新媒体库

这个过程中涉及多次115网盘API调用，在批量处理时极易触发风控。

解决方案建议

1. 使用STRM文件方案

替代直接操作网盘文件，推荐采用STRM文件方式：

• 在本地创建.strm文本文件
• 文件中包含115网盘文件的真实链接
• 媒体服务器通过.strm文件间接访问网盘内容

这种方式避免了频繁的网盘API调用，从根本上解决了风控问题。

2. 实现请求速率限制

如果必须使用直接操作网盘的方式，应该：

• 在代码中添加请求间隔控制
• 实现指数退避算法处理失败请求
• 限制并发请求数量

3. 缓存优化

对于频繁访问的目录信息：

• 实现本地缓存机制
• 减少重复的目录查询请求
• 设置合理的缓存过期时间

最佳实践

对于使用MoviePilot搭配115网盘的用户，建议：

1. 避免大规模批量操作网盘文件
2. 优先考虑STRM方案而非直接文件操作
3. 如需批量处理，应分批次进行并设置足够间隔
4. 关注115网盘官方的API调用限制说明

总结

115网盘的风控机制是为了保护服务器资源而设计的合理限制。MoviePilot作为自动化工具，在实现功能时需要充分考虑各平台的操作限制。通过采用STRM方案或优化请求策略，可以既实现媒体管理需求，又避免触发平台风控，保证系统的稳定运行。