Suwayomi-Server中AniList同步功能JSON解析错误的解决方案

问题描述

在Suwayomi-Server项目中，部分用户在使用AniList同步功能时遇到了JSON解析错误。当用户尝试将阅读章节信息同步到AniList时，系统会抛出"Expected start of the object '{', but had 'EOF'"的异常，导致同步功能无法正常工作。

错误分析

从日志信息可以看出，该错误发生在OAuth认证过程中。系统期望接收一个JSON对象（以'{'开头），但实际接收到的却是文件结束符（EOF）。这表明：

1. 认证信息可能已损坏或不完整
2. 存储的OAuth令牌可能已过期或格式不正确
3. 配置文件可能被意外修改

解决方案

经过验证，以下方法可以解决此问题：

1. 完全注销并重新登录AniList同步服务

   • 在Suwayomi界面中找到同步设置
   • 选择AniList同步服务
   • 执行注销操作
   • 重新登录并授权

2. 手动删除配置文件（进阶方案）

   • 停止Suwayomi-Server服务
   • 定位到数据目录下的sync_config.xml文件
   • 删除或重命名该文件
   • 重启服务并重新配置同步服务

预防措施

为避免此类问题再次发生，建议：

1. 定期检查同步服务状态
2. 避免在多个设备上同时使用相同的同步服务账号
3. 在升级Suwayomi-Server版本前，先备份配置文件

技术背景

Suwayomi-Server使用kotlinx.serialization库来处理JSON数据。当同步服务状态发生变化时，系统会将OAuth认证信息序列化为JSON格式存储在本地。如果这个过程中出现异常（如写入被中断、权限问题等），就可能导致JSON数据不完整，进而在下次读取时出现解析错误。

总结

虽然这个问题影响范围有限，但它提醒我们在处理用户认证数据时需要更加谨慎。开发者可以考虑在未来的版本中增加数据完整性检查和自动恢复机制，以提升用户体验。对于普通用户来说，按照上述解决方案操作即可恢复正常使用。