跳到主要内容

修复云同步中的文件名过长和特殊字符错误 — RcloneView 指南

· 阅读需 5 分钟
Tayson
Senior Engineer

你的同步任务在 47 个文件上失败了。错误提示"文件名过长"或"无效字符"。但这些文件在你这边看起来完全正常。欢迎来到跨提供商文件名兼容性的世界。

每个云存储提供商对文件名都有不同的规则。在 Google Drive 上完全合法的文件名,在 OneDrive 上可能就是非法的。在 S3 上可以正常使用的路径,可能会超出 Dropbox 的字符限制。在提供商之间进行同步时,这些不匹配会产生令人头疼的错误,甚至可能阻断整个传输任务。本指南介绍了最常见的问题及其修复方法。

RcloneView 应用预览

在一个地方管理和同步所有云端

RcloneView 是 rclone 的跨平台 GUI。通过清爽的可视化界面比较文件夹、传输或同步文件,并自动化多云工作流。

  • 一键作业:复制 · 同步 · 比较
  • 调度器与历史记录,实现可靠的自动化
  • 支持 Google Drive、OneDrive、Dropbox、S3、WebDAV、SFTP 等
WindowsmacOSLinux
免费开始使用 →

核心功能免费。Plus 提供自动化功能。

常见文件名问题

路径长度限制

提供商最大路径长度
OneDrive400 个字符
SharePoint400 个字符
Google Drive32,768 个字符
S31,024 个字符
Dropbox260 个字符
本地(Windows)260 个字符(默认)

层级很深且名称很长的文件夹很容易超过 OneDrive 或 Dropbox 的限制。

非法字符

字符Google DriveOneDriveS3Dropbox
\允许不允许允许不允许
?允许不允许允许不允许
*允许不允许允许不允许
:允许不允许允许不允许
< > |允许不允许允许不允许

在 Google Drive 上创建的文件名中包含 ?: 时,同步到 OneDrive 会失败。

尾部空格和句点

OneDrive 和 Windows 会拒绝以空格或句点结尾的文件名,而 Google Drive 则允许这种情况。这会导致隐藏的同步失败。

Unicode 与编码问题

非 ASCII 字符(日文、韩文、中文、表情符号)在大多数提供商上都能正常工作,但在较旧的系统或某些 S3 兼容提供商上可能会出问题。

如何诊断

检查任务历史

Find filename errors in job history

任务历史会准确显示哪些文件失败了以及失败原因。查找提到"invalid"(无效)、"too long"(过长)或"not allowed"(不允许)的错误信息。

识别问题文件

RcloneView 的终端允许你运行带详细输出的 rclone check,在尝试传输之前列出所有会失败的文件。

解决方案

在源端重命名有问题的文件

最干净的解决方法:在同步之前重命名文件,去除非法字符或缩短路径。

使用 rclone 的编码标志

Rclone 可以在传输过程中自动编码非法字符。在 RcloneView 的远程设置中配置这些选项,以处理跨提供商的兼容性问题。

扁平化深层文件夹结构

如果问题在于路径长度,可以将嵌套很深的文件夹重新组织为更扁平的结构。

使用文件夹对比查找不匹配项

Find filename mismatches

文件夹对比会高亮显示存在于源端但不存在于目标端的文件——这些往往就是因文件名问题而失败的文件。

快速上手

  1. rcloneview.com 下载 RcloneView
  2. 先对一个小文件夹运行测试同步
  3. 检查任务历史中与文件名相关的错误。
  4. 在源端修复文件名或配置编码。
  5. 使用文件夹对比重新运行并验证

修复方法通常比错误提示看起来要简单得多。


相关指南:

支持的云服务商

Local Files
WebDAV
FTP
SFTP
HTTP
SMB / CIFS
Google Drive
Google Photos
Google Cloud Storage
OneDrive
Dropbox
Box
MS Azure Blob
MS File Storage
S3 Compatible
Amazon S3
pCloud
Wasabi
Mega
Backblaze B2
Cloudflare R2
Alibaba OSS
Ceph
Swift (OpenStack)
IBM Cloud Object Storage
Oracle Cloud Object Storage
IDrive e2
MinIO
Storj
DigitalOcean Spaces