Aniyomi项目Shikimori跟踪功能404错误分析与修复方案

问题背景

在Aniyomi 0.15.2.4版本中，用户报告了一个关于Shikimori跟踪功能的异常问题。当用户尝试通过Shikimori服务跟踪动画时，系统会返回HTTP 404错误，导致跟踪功能无法正常使用。经过技术分析，发现这是一个典型的API端点配置错误问题。

技术分析

错误根源

通过检查ShikimoriApi.kt文件中的请求创建代码，发现问题的根本原因在于API请求路径中错误地使用了"mangas"而非正确的"animes"资源路径。这种资源路径不匹配导致Shikimori服务器无法识别请求，从而返回404 Not Found错误。

问题重现

1. 用户在Shikimori上添加动画到列表
2. 在Aniyomi应用中选择该动画进行跟踪
3. 应用向Shikimori API发送请求时使用错误路径
4. 服务器返回404错误响应

解决方案

代码修复

正确的修复方案是将API请求路径中的"mangas"替换为"animes"。这一修改直接对应Shikimori API的实际资源结构，确保请求能够正确路由到动画相关的处理端点。

修复验证

开发者通过以下步骤验证了修复的有效性：

1. 创建测试分支并修改相关代码
2. 使用临时邮箱创建Shikimori测试账号
3. 重新执行动画跟踪操作
4. 确认404错误不再出现，跟踪功能恢复正常

技术建议

对于类似API集成问题，建议开发者：

1. 仔细查阅第三方API文档，确认资源路径命名
2. 实现完善的错误处理和日志记录机制
3. 为API集成编写单元测试，覆盖主要功能场景
4. 考虑使用API客户端库（如Retrofit）来减少手动构建请求的错误

总结

本次问题的解决展示了API集成中资源路径配置的重要性。通过准确匹配API服务端的资源命名约定，开发者可以避免类似的404错误。Aniyomi团队已将此修复合并到主分支，用户将在后续版本中获得修复后的稳定跟踪功能。