NSMetadataQuery无法搜索外部iCloud容器中子目录的问题求助

测试环境：iOS 18.4.1 / macOS 15.4.1

我现在在做一个iOS项目，核心需求是借助用户的iCloud Drive文档目录来存储一套自定义的多层目录文件结构。具体来说，我需要让用户在iCloud Drive里选择一个应用容器之外的根目录，然后在这个根目录下创建多层嵌套的子文件夹，用来存放用户自己生成的各类文件。

最近我一直在尝试用NSMetadataQuery来实现相关的目录搜索和文件遍历功能，试了好多种谓词组合和搜索配置，但始终没法正确搜索到外部iCloud容器里的子目录内容——要么完全搜不到目标目录/文件，要么返回的结果缺东少西，完全不符合预期。

比如我已经设置了NSMetadataQueryUbiquitousDocumentsScope作为搜索范围，也试过针对NSMetadataItemFSNameKey和NSMetadataItemIsDirectoryKey来编写谓词，但不管怎么调都没解决问题。有没有做过类似需求的朋友能给我指条路？用NSMetadataQuery处理外部iCloud容器的子目录搜索时，正确的姿势应该是怎样的？有没有什么容易忽略的权限或者配置细节？

内容来源于stack exchange