若mendeley desktop元数据无法上传云端，同步图标长期暂停或报错，可依次尝试：一、配置socks5代理（127.0.0.1:1080）；二、启用元数据同步并禁用pdf上传；三、备份后重置并恢复数据库；四、通过注册表重定向数据目录至同步网盘；五、登出并刷新oauth令牌。
如果您在使用Mendeley Desktop时发现文献元数据（如标题、作者、标签、笔记）无法上传至云端，右下角同步图标长期显示暂停或错误提示，且反复点击“Sync Now”无响应，则很可能是由于网络代理配置缺失、云同步功能被意外禁用、本地数据库损坏或账户认证状态异常所致。以下是多种可独立实施的修复方法：
一、检查并配置代理连接设置
该方法适用于中国大陆用户，因Mendeley官方服务器受网络环境限制，未配置代理将导致元数据同步请求被拦截或超时，从而表现为“完全无法同步”。正确配置SOCKS5代理后，软件可直连云端完成认证与数据交换。
1、启动Mendeley Desktop，点击菜单栏Tools → Options（Windows）或Mendeley Desktop → Preferences（Mac）。
2、切换至Connection选项卡。
3、在Proxy Type中选择SOCKS5；在Proxy Server栏输入127.0.0.1；Port栏填写1080。
4、勾选Use system connection settings（若已开启系统级代理，此步可跳过）。
5、关闭设置窗口，观察右下角账户名旁是否出现旋转同步图标；若数秒内显示“Sync successful”，则代理配置生效。
二、启用元数据同步并禁用PDF冗余上传
该方法通过重置同步策略，确保轻量元数据强制走云端通道，同时规避因PDF附件同步失败引发的整体阻塞。Mendeley默认可能误启“Synchronize attached files”，在带宽受限或路径异常时会拖垮整个同步队列。
1、进入Tools → Options → Synchronization选项卡。
2、确认勾选Synchronize library metadata（此项必须启用）。
3、取消勾选Synchronize attached files（关键操作，防止PDF触发失败回滚）。
4、点击Save & sync，等待界面右下角提示Sync completed。
三、重建本地数据库并恢复备份
该方法用于解决因数据库文件损坏、权限丢失或版本不兼容导致的同步中断。Mendeley Desktop在异常退出后可能遗留锁文件或索引错乱，使同步模块拒绝初始化。
1、点击菜单栏Help → Create Backup，保存当前全部元数据与标注至本地指定文件夹（如：D:\Mendeley_Backup\20260428.bak）。
2、点击Help → Reset Mendeley Desktop，确认删除所有本地缓存与临时数据。
3、完全退出Mendeley Desktop进程（任务管理器中结束所有mendeleydesktop.exe）。
4、重新启动软件，登录账户后立即点击Help → Restore Backup，选择步骤1中生成的备份文件。
5、等待恢复完成，观察右下角是否开始自动同步；若仍无反应，继续执行下一步。
四、强制重定向数据目录至同步网盘路径
该方法绕过默认AppData路径的读写权限冲突与跨设备路径漂移问题，将Mendeley核心数据库（含所有分组结构、笔记、高亮坐标）托管至坚果云/OneDrive等可靠同步服务，确保账户登录即加载最新状态。
1、按Win + R输入%APPDATA%，定位到路径：C:\Users\[用户名]\AppData\Roaming\Mendeley Desktop，记下完整地址。
2、新建同步文件夹（如：C:\Sync\MendeleyData），将其添加至坚果云客户端同步列表。
3、以管理员身份运行regedit，导航至：HKEY_CURRENT_USER\Software\Mendeley Ltd.\Mendeley Desktop。
4、右键空白处 → 新建 → 字符串值，命名为dataDirectory。
5、双击该值，输入同步文件夹路径，注意使用正斜杠：C:/Sync/MendeleyData。
6、重启Mendeley Desktop，确认软件从新路径加载数据库且右上角同步图标持续活动。
五、验证账户登录状态并刷新OAuth令牌
该方法针对账户认证过期、Token失效或第三方授权异常场景。Mendeley Desktop依赖OAuth 2.0长期凭证维持云端连接，若凭证被撤销或静默过期，将静默拒绝所有同步请求而不报错。
1、点击右上角账户名 → 选择Log Out，完全退出当前会话。
2、关闭Mendeley Desktop所有进程。
3、手动删除临时认证文件：进入路径%LOCALAPPDATA%\Mendeley Ltd\Mendeley Desktop\cache，清空其中全部内容。
4、重新启动软件，点击Log In，使用浏览器完成完整OAuth流程（非自动跳转）。
5、登录成功后，等待10秒，观察是否自动触发首次全量元数据拉取；若界面顶部出现Syncing 127 items...即表示令牌已刷新成功。
