[BUG]: Desktop “Document Processor Unavailable” on launch

问题场景

用户运行 AnythingLLM 桌面版，在 macOS 上启动应用后看到 Document Processor 不可用，无法从工作区上传任何文件，界面提示 Document Processor Unavailable。

报错原文

[BUG]: Desktop "Document Processor Unavailable" on launch

Already in sync, no schema change or pending migration was found.

EPERM: operation not permitted, open '/Applications/AnythingLLM.app/Contents/Resources/backend/node_modules/.prisma/client/index.js'

Environment variables loaded from .env
Prisma schema loaded from prisma/schema.prisma
Error:
EPERM: operation not permitted, open '/Applications/AnythingLLM.app/Contents/Resources/backend/node_modules/.prisma/client/index.js'

node:internal/modules/cjs/loader:1087
  throw err;
  ^

Error: Cannot find module '.prisma/client/index'
Require stack:
- /Applications/AnythingLLM.app/Contents/Resources/backend/node_modules/@prisma/client/index.js
- /Applications/AnythingLLM.app/Contents/Resources/backend/server.js
    at node:internal/modules/cjs/loader:1084:15
    at Function._resolveFilename (node:electron/js2c/utility_init:2:3040)
    at Module._compile (node:internal/modules/cjs/loader:1271:14)
    at Object..js (node:internal/modules/cjs/loader:1326:10)
    at Module.load (node:internal/modules/cjs/loader:1126:32) {
  code: 'MODULE_NOT_FOUND'
}

Node.js v18.16.1
Collector hot directory and tmp storage wiped!
[production] AnythingLLM Standalone Document processor listening on port 59647

原因分析

根据 Issue 中用户 @PieroPicc 的定位，问题是由于 macOS 的 System Integrity Protection (SIP) 引起：当 App 被安装在根目录 /Applications 时，Prisma 无法写入或访问 node_modules/.prisma/client/index.js，产生 EPERM: operation not permitted 并进一步导致 Cannot find module '.prisma/client/index'，Document Processor 因此不可用。维护者补充，多用户 Windows 系统如果安装到全局目录也可能出现同类权限问题。

另外，Issue 中也有用户反馈上传音频或视频时 Document Processor 会因转写暂停排队功能，转写结束后自行恢复；不过本 Issue 的原始截图和日志指向的是安装权限问题，而不是转写排队。

环境排查

• 确认正在使用的是 AnythingLLM 桌面应用，而不是浏览器访问的服务端版本。
• 确认 macOS 型号与芯片：Issue 中 Intel Mac 正常、M1 Mac 复现较多。
• 确认 AnythingLLM.app 的实际安装路径是根目录 /Applications 还是当前用户目录 ~/Applications。
• 确认是否存在多用户共用同一份根目录安装的情况。
• 如需抓取日志，可完全退出 App 后，在 Terminal 运行 /Applications/AnythingLLM.app/Contents/MacOS/AnythingLLM，观察终端输出中的 Prisma 与 Node.js 报错。
• 检查 Node.js 及 Prisma 相关报错，重点看是否出现 EPERM 或 MODULE_NOT_FOUND。

解决步骤

1. 完全退出正在运行的 AnythingLLM，确保进程不再占用安装目录。
2. 打开 Finder，使用 Go → Go to Folder，输入 ~/Applications，进入当前用户的 Applications 目录。
3. 如果该目录不存在，先在当前用户主目录下创建 Applications 文件夹。
4. 将根目录 /Applications 中的 AnythingLLM.app 拖拽或移动到 ~/Applications。
5. 从 ~/Applications 中重新启动 AnythingLLM，再尝试上传文件，确认 Document Processor 是否恢复。
6. 如果问题依旧，可优先尝试查看相关 Issue #875 中是否记录了更多排查方向。

验证方法

从 ~/Applications 启动 AnythingLLM 后，界面不再显示 Document Processor Unavailable，并且可以在工作区中正常上传文件，即视为问题解决。如果 Terminal 中不再出现 EPERM: operation not permitted 与 Cannot find module '.prisma/client/index'，说明 Prisma 模块权限问题已经绕过。

参考来源

Mintplex-Labs/anything-llm #866

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。