Aniyomi项目MyAnimeList追踪功能故障分析与解决方案

问题背景

Aniyomi是一款流行的开源动漫管理应用，其0.15.2.4版本中出现了MyAnimeList(MAL)追踪功能失效的问题。用户反馈在登录MAL账户后，应用无法保存认证令牌，导致无法自动同步观看记录。

故障现象

主要症状表现为：

1. 用户成功登录MAL账户后，应用无法持久化保存认证令牌
2. 每次打开追踪功能都需要重新登录
3. 观看记录无法自动同步到MAL平台
4. 该问题仅影响MAL追踪，其他追踪服务如AniList工作正常

技术分析

根据社区反馈和开发者确认，该问题可能与以下因素有关：

1. 用户代理(UA)字符串兼容性问题：MAL的API接口可能对某些UA字符串有特殊限制或验证机制
2. OAuth认证流程变更：MAL可能更新了其认证协议或令牌管理方式
3. Android 14兼容性问题：新操作系统版本可能引入了某些权限或网络限制

解决方案

临时解决方案

用户可以通过修改默认用户代理字符串来解决此问题：

1. 进入应用设置 > 高级选项
2. 找到"默认用户代理字符串"设置项
3. 修改为以下值：

Mozilla/5.0 (Linux; Android 13; SM-S901U) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/112.0.0.0 Mobile Safari/537.36

长期解决方案

开发者已在预览版中修复此问题，建议用户：

1. 等待下一个稳定版更新
2. 或切换到预览版获取最新修复

技术原理

用户代理字符串是HTTP请求头的一部分，用于标识客户端类型和版本。某些网站(如MAL)会根据UA字符串实施不同的安全策略或功能限制。修改UA字符串可以：

1. 绕过某些API限制
2. 模拟更常见的浏览器环境
3. 避免被识别为自动化工具而受限

预防措施

为避免类似问题，建议：

1. 定期检查并更新用户代理字符串
2. 关注MAL API变更公告
3. 及时更新应用到最新版本

总结

Aniyomi的MAL追踪功能问题主要源于用户代理兼容性问题，通过修改UA字符串可有效解决。开发者已在后续版本中修复此问题，建议用户关注更新或采用临时解决方案。这类问题在第三方应用与平台API集成中较为常见，理解其原理有助于更快定位和解决问题。