MarkLogic恢复森林后遇SVC-FILRD错误：S3备份文件本地缺失

API 探路者

2026-7-7

问题分析与排查方向

以下是可能导致部分二进制文件未恢复成功的原因及对应排查步骤：

恢复过程存在静默失败
恢复任务可能因网络波动、S3访问限流等原因，出现单个文件下载失败但未终止整体进程的情况。检查MarkLogic的ErrorLog.txt（通常在/var/opt/MarkLogic/Logs/目录），或执行xdmp:forest-restore-status()查看恢复任务的详细状态，确认是否有文件级别的报错记录。
本地存储路径权限或配置不符
确认MarkLogic进程对目标森林目录/var/opt/MarkLogic/Forests/content-lake-raw-1/Large/拥有读写权限。另外，若恢复时指定的本地存储路径与原森林的路径结构不一致，可能导致文档元数据指向的本地文件路径不存在。可对比原森林的存储配置，检查恢复命令中是否正确指定了路径参数。
备份文件完整性问题
S3中可见的文件可能存在损坏或备份时未完整生成。使用xdmp:backup-verify()工具验证S3备份集的完整性，或对比备份文件的哈希值（如MD5）与原文件是否一致，排除文件损坏的可能。
文档分片映射异常
MarkLogic将文档分片存储，恢复时可能出现分片映射未正确重建的情况。执行xdmp:document-properties("mc-2022-vol57/mc-2022-vol57.ch06/graphic/mc-2022-vol57.ch06_g05.tif")查看文档的存储元数据，确认其指向的分片和本地路径是否与实际存储目录匹配。
备份集不完整
森林备份包含分片数据、元数据等多个关联文件，若S3中的备份集缺少部分文件（如分片索引、文档映射文件），恢复后会出现部分文档缺失。确认S3备份路径下的所有文件都完整，恢复时指定了正确的根备份路径。