macOS运行MarkLogic应用服务器报File open error - operation not permitted错误

报错信息：

500 Internal Server Error
SVC-FILOPN: File open error: open '/Users/rishabh/Downloads/mls-semantics/projects/top-songs/index.xqy': Operation not permitted
in / [1.0-ml]

1. 确认MarkLogic服务运行身份 #

MarkLogic默认以独立的系统用户运行，而非当前登录的操作系统用户，仅给个人用户授予路径权限不会生效：

• macOS环境执行命令查看运行用户：ps aux | grep MarkLogic，输出结果第一列即为运行用户，默认通常为daemon或marklogic。

2. 排查路径权限与系统限制 #

报错核心是服务用户无文件读取权限，需逐层校验：

• 确保服务用户对路径上的每一级目录都有执行权限（进入目录的权限），对目标xqy文件有读权限：需校验的路径层级依次为/Users → /Users/rishabh → /Users/rishabh/Downloads → /Users/rishabh/Downloads/mls-semantics → /Users/rishabh/Downloads/mls-semantics/projects → /Users/rishabh/Downloads/mls-semantics/projects/top-songs → 最终的index.xqy文件。
• macOS的Downloads文件夹默认开启隐私访问限制，会禁止非当前用户的进程访问目录内容，优先建议将应用目录迁移到无系统限制的路径，例如/Users/Shared/目录下测试。

3. 校验应用服务器配置 #

• 确认8040端口对应的应用服务器「根目录」配置与实际文件夹路径完全一致，无拼写、大小写错误。
• 确认应用服务器的执行权限配置未限制XQuery脚本的读取执行，未修改过默认配置可跳过此步。

4. Query Console插入文档权限问题处理 #

Query Console出现同类权限报错属于MarkLogic内部权限配置问题，与本地文件系统权限无关：

• 确认你登录Query Console的用户对目标数据库有插入、更新权限，可临时给用户赋予admin角色验证，验证通过即可确认是角色权限配置不足，补对应权限即可。
• 确认目标数据库未配置强制文档权限规则，要求所有插入的文档必须指定特定角色的读写权限，未指定就会触发拒绝。

5. 快速定位测试方案 #

可以通过以下操作快速确认问题根因：

1. 将top-songs整个文件夹复制到/Users/Shared/路径下
2. 执行命令递归开放路径权限：sudo chmod -R 777 /Users/Shared/top-songs
3. 修改应用服务器根目录为新路径，重启MarkLogic服务后访问测试
   如果测试可正常访问，说明问题完全由原路径的系统保护或权限配置错误导致，无需调整其他配置。

内容的提问来源于stack exchange，提问作者Rishabhg