rea.bestEnglish ↗
TROUBLESHOOTING

先找到卡住的那一步。

从最小检查开始。搜索在本地进行,无需上传日志。

macOS:SwiftBridging 模块重复定义

这是本站案例遇到并解决的具体故障。失败发生在 macOS 进程检查组件的编译阶段,尚未解析目标脚本;最小 Swift 程序也报同样错误。

macOS process ownership helper compilation failed
redefinition of module 'SwiftBridging'

核对根因

该环境的 Swift include 目录里,旧 module.modulemap 和 bridging.modulemap 重复声明了相同模块。案例脚本会严格核对内容,不匹配时停止。

使用项目局部修复

下载案例包,在解压目录运行以下步骤(需要 Python 3)。脚本创建局部 VFS 映射与编译器包装器,不修改系统文件,也不关闭 REA 的进程检查。

python3 prepare-swift-workaround.py
source .rea-local/env.sh
npx -y rea-agents@6.5.0 analyze-javascript-application ./case-source --json > result.json

修复记录环境为 macOS arm64、Swift 6.1、SDK 15.4。打开新终端可停止使用这组临时变量;工具链更新后应先在无映射的新终端验证。

查看脚本 ↗ · 下载案例包 ↓

查看修复后的分析证据 →

Node 版本不兼容

运行 node --version 和 npm --version。REA 6.5.0 声明支持 Node 22.19+(22.x)、24.11+(24.x)或 26+。Node 23、25 不在声明范围。切换后重开终端,确认 PATH 中的 Node 已改变。

配置完成,但代理看不到 REA MCP

确认 setup 选中的是正在使用的客户端,并已批准配置计划。完全退出并重启代理,再运行对应的 doctor --client 命令。只有 skill 不等于 MCP 已注册;doctor 注册通过也不等于分析引擎已准备好。

找不到 Ghidra / Hopper / IDA

先确认需要原生二进制分析。静态 JavaScript 案例无需这些引擎。需要引擎时,先验证它能独立启动,再按官方文档配置路径;Windows Ghidra 路径需核对实验性支持说明。

目标目录或文件无法读取

检查目标是否存在、当前用户是否可读。含空格的路径用双引号包围。JavaScript 分析使用解包目录或受支持的 ASAR,不把安装包直接当源码目录。先用本站冻结案例缩小问题范围。

Linux 的 ps / 进程检查失败

检查 command -v ps。相关 Linux 分析路径要求 procps 兼容的 ps;按发行版安装相应软件包并确认它位于当前 PATH。

网页分析连不上浏览器

网页地址不是浏览器调试端点。按官方指南建立专用 Chromium 调试会话,确认代理使用该会话的端点,并检查目标页面是否已打开。

除标注的 Swift 案例外,这些是根据文档整理的检查路径,不是对你当前环境的诊断。 官方安装与诊断文档 →