rclone 423 Locked 错误解决方法

摘要：本文总结了 rclone 在执行 ls 或 lsf 命令时遇到的 423 Locked 错误，分析了可能原因并提供了多种解决方案，包括等待、限制并发、清除缓存、重新授权等。

1. 问题描述

你遇到了以下 rclone 错误信息：

Failed to lsf with 2 errors: last error was: error in ListJSON: couldn't list files: 423 Locked

该错误表示 **Rclone 在尝试列出远程存储（如 OneDrive、Google Drive 等）文件时遇到了 HTTP 423 错误：Locked**。

2. HTTP 423 Locked 是什么？

HTTP 423 是 WebDAV 协议中的一个标准响应码，意思是“资源被锁定”（Locked）。在使用 Rclone 连接某些云服务（尤其是 OneDrive 或私有 WebDAV 服务）时，如果该目录或文件正在被其他操作占用或锁定，就可能返回这个错误。

3. 可能原因

### 3.1 OneDrive 文件/目录被锁定 - 某个同步客户端（例如网页端、桌面客户端）正在编辑或访问该文件夹。 - 文件正在上传、下载或处理中。 ### 3.2 并发访问冲突 - 多个 rclone 命令同时运行，导致资源竞争。 - 其他程序（如网盘同步工具）正在访问同一路径。 ### 3.3 WebDAV 服务器限制 - 如果你使用的是自建 WebDAV 服务（如 Nextcloud、群晖等），它可能对某些操作加锁了资源。 - 配置不当或插件冲突也可能导致此问题。 ### 3.4 OneDrive API 临时问题 - 微软 OneDrive 后端服务短暂异常或限流。 ### 3.5 缓存或 token 问题 - Rclone 的缓存数据或 OAuth token 异常，可能导致访问失败。

4. 解决方法

### 4.1 等待一段时间再试 有时是临时性的问题。可以稍等几分钟后重试：

sleep 60 && rclone lsf remote:path

### 4.2 检查是否有多进程在访问 确认没有多个 rclone 命令或其他程序（如 OneDrive 客户端）正在访问该资源。

ps aux | grep rclone

如有，结束无关进程。 ### 4.3 重启 WebDAV 服务（如果是私有服务） 比如重启 Nextcloud、Apache、Nginx 或 Synology 的相关服务。 ### 4.4 清除 Rclone 缓存 有时缓存会导致奇怪的问题，可尝试清除：

rclone rmdir remote:path --disable cache-expire,cache-get,cache-put,cache-replicate

或者直接删除缓存目录（位置可通过 `rclone config dir` 查看）。 ### 4.5 重新授权远程（re-auth） 重新配置远程连接以刷新 token：

rclone config reconnect remote:

或者更彻底地重新配置：

rclone config

选择对应 remote，然后重新认证。 ### 4.6 降低并发数 / 请求速率 使用以下参数减少并发请求，避免触发限速或锁定机制：

rclone lsf remote:path --checkers=1 --transfers=1 --fast-list

5. 调试建议

你可以开启 rclone 的调试日志来进一步排查问题：

rclone lsf remote:path --verbose --log-file=rclone.log --dump=headers

查看 `rclone.log` 中的详细请求和响应头信息。

6. 不确定是哪个远程？

运行：

rclone config show

确认你的 remote 类型和配置。

7. 总结

| 原因 | 解决方法 | |------|----------| | 文件被占用 | 等待或关闭其他程序 | | 并发冲突 | 限制并发数或终止多任务 | | 服务端锁定 | 重启服务或等待 | | token 问题 | 重新授权 remote | | 请求过快 | 减少 checkers 和 transfers |