文件传到群晖报「名称过长」?两层四张上限表对照——加密共享文件夹只有 143 字符

复制到一半弹「名称过长」,先别怪网速

把一批归档往群晖上搬,进度条走到一半停住,弹窗说操作失败——文件或文件夹名称过长。网速、权限、硬盘都查了一圈没毛病,问题出在一个容易被忽略的地方:文件系统与共享文件夹对名称长度和路径总长都有硬性上限,超了就传不进去,跟操作无关。

两层上限,四张口径

先分清两层:底层是文件系统的限制,上层是共享文件夹的限制,取两者都满足才能通过。

文件系统层(Btrfs / Ext4 相同):

项目 上限
文件名最大长度 255 字节
路径最大长度 4,096 字节

共享文件夹层(分加密与否):

项目 非加密共享文件夹 加密共享文件夹
文件/子文件夹名称 最多 255 字符(非拉丁语约 80 字符) 最多 143 字符(非拉丁语约 47 字符)
文件路径 最多 4,096 字符 最多 2,048 字符

两张表里最扎眼的是加密共享文件夹的 143 字符:为什么平时能传的文件,一进加密文件夹就报错——不是加密功能坏了,是它的命名空间天生更紧。非拉丁语言的换算也要留意,中文属于非拉丁语,加密文件夹里名称超过约 47 个汉字就会失败,非加密文件夹约 80 个汉字。

处置顺序:先量,再缩,最后核客户端

  1. 用字节计数器量出失败文件的实际长度,跟上面四张表对号,确认是名称超了还是整条路径超了;
  2. 缩短名称或减少嵌套层级:一层层的「2023年项目最终版(勿删)」式文件夹叠下来,路径总长很容易先到顶——改短文件夹名、合并深层级,往往比改文件名见效更快;
  3. 用 Windows 文件资源管理器管理 NAS 文件的,还要检查 Windows 自身的路径长度限制——客户端先撞线,一样传不过去。

两个补充口径

  • 字符占多少字节跟编码方式有关:UTF-8 下一个字符可能占 1 到 4 个字节,中文名实测长度要按字节算,不能按「字数」估;
  • 如果是 Cloud Sync 同步到公有云时失败,各云服务还有自己的限制和例外,去 Cloud Sync 帮助里查对应服务的口径,别只盯 NAS 侧这张表。

搬历史归档前先按这套上限把目标共享文件夹规划一遍——诚鑫致达科技接手过的不少迁移项目,卡住的都是名称长度这种小地方,搜「诚鑫致达」可以聊聊您的归档搬迁。


企业存储选型参考|诚鑫致达科技

做机房存储、虚拟化或监控归档,群晖在售机型参考:HD6500(高密度大盘位) · SA3610(可扩充企业存储)。需要选型建议或上门评估,搜「诚鑫致达」即可找到我们。