x10000文件存储，cifs共享盘，挂载到windows上，突然看不到之前的文件了

根因：CephFS 目录目录项 (dentry) 元数据异常，目录底层 inode、文件数据完好；但是目录名字段解析异常，WebUI 的目录浏览器无法解析非法 / 异常目录名，展示为空白；Windows SMB/CIFS 客户端解析目录元数据失败，无法列举子文件；底层 ceph 存储的 OSD 数据没有损坏，数据是安全的，不要删除该目录！

⚠️重要禁忌：不要在 Web 界面点删除这个空格目录，会连带删掉全部业务数据。

前置检查（SSH 登录 MDS 管理节点执行）

1. 确认 ceph 集群整体健康

确认HEALTH_OK，OSD 全部 up，MDS 全部 active，无 osd 损坏。 2. 进入父目录，确认异常目录：ls 会看到一个名称为空串 / 乱码目录，cd 可以进入，ls 里面业务文件全部存在。

处理方案（优先方案：原地重命名修复目录项）

原理：数据 inode 没有损坏，仅仅目录的目录项名字损坏，在父目录执行 rename，给异常目录赋予合法新名称，修复 dentry 元数据，WebUI、CIFS 即可恢复识别。

1. SSH 进入 cephfs 的父目录（不要进入异常空格目录内部）
2. 使用renameat方式重命名（不能直接 mv，名字是空字符串普通 mv 识别失败）

执行完成后，父目录下出现temp_bak，进入 temp_bak，确认业务文件全部还在。

⚠️执行重命名操作期间，建议临时停止业务读写，断开所有 Windows CIFS 挂载，避免重命名瞬间产生读写报错。

3. 重命名成功之后：

• 刷新 X10000 Web【目录管理】，现在可以正常看到temp_bak目录，Web 页面可以浏览内部文件；
• Windows 重新 CIFS 挂载，可正常看到目录与文件。

CIFS 共享配置修复

1. Web【NAS 管理】→【CIFS 共享】，原来绑定旧异常目录的 CIFS 共享，现在目录路径失效；
2. 编辑原有 CIFS 共享，修改共享目录路径指向重命名后的temp_bak目录；
3. 保存，Windows 客户端重新断开重连 CIFS 共享。

如果原来的共享名不想变，重命名完成业务验证没问题后，可以再次 rename 改回原来业务目录名字。

备选方案（如果 find mv 方式失败）

1. 在父目录新建一个正常名字的业务目录；
2. cd 进入旧的空格异常目录，把里面所有文件、子目录全部cp -rp复制到新建目录；
3. 全部复制校验完成，确认文件大小、数量完全一致；
4. 修改 CIFS 共享指向新目录；

❗不要直接 rm 删除旧异常目录，复制全部数据确认业务完全正常之后，再考虑清理旧目录。

排查为什么出现该故障

常见触发诱因：

1. Windows 客户端 CIFS 写入创建目录，目录名包含非法特殊字符、尾部空格、全角特殊符号，CephFS MDS 元数据处理异常，目录 dentry 损坏；
2. MDS 进程异常重启、瞬间 MDS 故障切换，写目录元数据中途中断，目录项写一半损坏；
3. 老版本 ONEStor/X10000 MDS 存在目录项处理 bug，建议查看版本说明书，有对应缺陷就升级存储版本。

收集日志：查看 MDS 日志

操作完成之后验证清单

1. ceph -s集群状态健康无告警；
2. Web 目录管理可以正常浏览目录，文件数量、大小核对；
3. Windows CIFS 挂载，读写新建、修改、删除文件测试；
4. 业务应用访问 CIFS 共享业务验证。

紧急建议

该场景属于 MDS 元数据目录项异常，虽然数据还在，属于存储元数据故障，建议开 H3C 400TAC 工单，把现象、ceph -s 输出、MDS 日志一并提交原厂，确认是否是已知版本 bug。

禁止操作清单： ❌不要 WebUI 删除显示空白的目录； ❌不要直接 rm -rf 这个空名目录； ❌不要直接重启 MDS 集群，先备份确认文件完好； ❌不要直接升级存储版本，先把元数据故障修复。