TachiyomiSY中MyAnimeList追踪功能故障排查指南

问题现象分析

近期在TachiyomiSY 1.10.5版本中，部分用户反馈无法正常使用MyAnimeList(MAL)追踪功能。具体表现为：当用户尝试在追踪设置中选择MAL并完成授权流程后，系统虽然显示加载动画，但最终返回追踪设置页面且未显示成功标记，导致无法通过应用追踪漫画阅读进度。

故障重现步骤

1. 进入TachiyomiSY的追踪设置
2. 选择MyAnimeList选项
3. 被重定向至MAL网页进行登录
4. 完成账户登录并授权操作
5. 返回应用后显示加载动画
6. 最终返回追踪设置页面，无成功标识

技术背景

TachiyomiSY通过OAuth协议与MyAnimeList进行集成，需要特定的用户代理(User Agent)字符串来标识客户端身份。在某些Android 14设备上，特别是三星S22系列，默认的用户代理字符串可能导致MAL服务器拒绝认证请求。

解决方案

经过技术团队排查，发现以下解决方法：

1. 进入TachiyomiSY的"高级设置"
2. 找到"默认用户代理"设置项
3. 修改默认的"Windows NT 10.0"字符串
4. 建议删除其中的"NT"部分，改为"Windows 10.0"
5. 保存设置后重新尝试MAL授权流程

原理说明

用户代理字符串是HTTP请求头的一部分，用于向服务器标识客户端环境。MyAnimeList服务器可能对某些用户代理字符串有特殊限制或验证逻辑。修改后的用户代理字符串更接近常见浏览器配置，能够通过MAL的认证检查。

预防措施

对于开发者而言，建议：

1. 在应用中内置多种备选用户代理字符串
2. 实现自动重试机制，在首次认证失败时尝试备用配置
3. 提供更明确的错误提示信息，帮助用户快速定位问题

对于终端用户，可以：

1. 定期检查应用更新，获取最新修复
2. 遇到类似问题时尝试清除应用缓存
3. 在社区中分享解决方案，帮助其他用户

结语

这类认证问题在第三方应用与主流服务集成时较为常见。通过调整用户代理设置，大多数用户都能成功恢复MAL追踪功能。TachiyomiSY团队将持续优化认证流程，提升用户体验。