故障排除
找到您看到的消息，阅读原因并按方法处理。
| 您看到的现象 | 原因与解决方法 |
|---|---|
SFTP connections require a managed xEvolve Agent | 该连接没有代理。编辑连接，选择已安装的代理，然后重新测试。FTP、FTPS、SMB 和 NFS 同理。 |
代理无法注册，API 返回 workspace_not_ready | XEVOLVE_API_URL 指向 api.xevolve.io。请使用您的工作区地址 https://<workspace>.xevolve.io。 |
| 测试代理显示为绿色，但没有心跳 | 测试代理不会验证密钥。请将 AGENT_SECRET 和 XEVOLVE_API_TOKEN 与指南中的密钥比对。如果丢失，请创建新代理。 |
代理部署指南显示 <agent-secret> | 密钥只在创建代理时显示一次。请创建新代理以获得新密钥。 |
403 API key missing required scope | 添加消息中指出的范围。创建新密钥；现有密钥的范围无法扩大。 |
| 创建密钥时出现 403 | 密钥只能授予自己拥有的范围。请使用控制台会话，或拥有所有所需范围的密钥。 |
| 上传被 422 拒绝 | 扫描阻止了该文件。请在审计日志中查看扫描详情。 |
| 分享链接返回 410 | 链接已过期或已达到下载上限。请创建新链接。 |
浏览 SFTP 文件夹时路径重复，如 /upload/upload | 该连接同时设置了路径和基础路径。请只保留一个。 |
| 合作伙伴无法导入在 xEvolve 中创建的密钥 | GnuPG 无法读取 OpenPGP v6 格式。请用 gpg 创建密钥并导入 xEvolve。 |
| Webhook 不再收到事件 | 投递失败会被计数，不会重试。请修复接收端并发送测试事件。 |
如有其他问题，请发送邮件至 hello@spot-suite.com，并附上您的工作区地址。