# 故障排除

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/idea/llms.txt).

JetBrains IDEs 的   远程开发   功能仍处于积极开发阶段，因此可能会出现一些问题。 此页面旨在帮助您在设置或以后的工作中进行初步故障排除。

> **Note:**
> 确保您已经了解我们的文档中 [《系统要求》](prerequisites-for-dev-containers.html)和 [《常见问题解答》](faq-about-remote-development.html)部分。

## 设置

|  问题  |  答案  |
| --- | --- |
|  JetBrains Gateway 有什么不同吗？从 Toolbox 下载的，与单独下载的，还是从 IDE 下载的？  |     独立版 JetBrains Gateway 支持用于“在 IDE 中打开” [基于 Space 的项目](https://www.jetbrains.com/zh-cn/help/space/getting-started.html#what-is-space)的选项。如果不使用此选项，安装程序和工作流程没有其他差异。       检查 [安装场景](jetbrains-gateway.html)。     |
|  我可以将 Remote Development 指向我远程服务器上的现有 IDE 吗？ 是否可以手动安装 IDE？  |     自从版本   221.5481   以来，您可以手动注册远程服务器上的现有后端 IDE，并使其对 JetBrains Gateway 可见。 已安装的 IDE 将出现在可用构建的列表中：        1.     通过 SSH 进入远程服务器。        2.     找到解压后的 IDE 文件夹，进入  `bin`  文件夹。        3.     在命令行中，执行以下命令：       ``` remote-dev-server.sh registerBackendLocationForGateway ```      例如，       ``` sh IDEA-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway ```       |
|  JetBrains Gateway 安装本身未能成功完成  |      * 请确保您的系统用户有权限安装软件，或者联系您组织中的系统管理员。    |
|  为什么在设置过程中 SSH 连接到远程服务器失败？  |      * 远程服务器端或虚拟机提供商禁止传入连接。 对于 AWS，请不要忘记调整“安全组”    * 在远程端，您的 SSH 监听非标准端口    * 密码或密钥文件不正确或由于多次失败导致连接被阻止    |
|  JetBrains Gateway 在   检索 IDE 版本  步骤挂起，无法加载可用的 IDE  |      * JetBrains Gateway 无法连接到 [JetBrains 的站点](https://data.services.jetbrains.com/products)以获取现有构建的列表    |
|  JetBrains Gateway 尝试连接但失败。 凭证 100% 正确。  |      * 请让服务器管理员在 `sshd_config` 中允许 TCP 转发。 JetBrains Gateway 需要 `AllowTcpForwarding` 才能通过 SSH 转发 IDE 连接。    |
|  我从本地计算机选择了一个 IDE 安装程序，但上传过程失败了  |      * 远程服务器的磁盘可用空间不足。 您的远程服务器上的可用空间必须至少为 4xIDE.tar.gz 。 自 2022.1.1 版起，您可以在远程服务器上选择自定义路径作为部署目标位置。    * 您上传的不是 .tar.gz 安装程序存档，因此无法在远程端解压。    * 您上传了 Community 版本的归档。 远程开发适用于付费版本。    |
|  上传 remote-dev-worker 失败，显示“退出代码: 139 (SIGSEGV)”  |  如果您的远程机器操作系统是 RHEL、CentOS、RockyLinux，请检查   SELinux 警告的 syslog   或禁用 SELinux 并重试安装  |
|  在本地机器上，进程因“无法下载 JetBrains Client”错误而失败  |     您的本地计算机必须与以下 JetBrains URL 建立网络连接：        * https://code-with-me.jetbrains.com    * https://download.jetbrains.com    * https://download-cf.jetbrains.com    * https://download-cdn.jetbrains.com    * https://cache-redirector.jetbrains.com      或者，您可以配置 [完全离线模式](fully-offline-mode.html)。     |

## 与远程项目协作

|  问题  |  答案  |
| --- | --- |
|  60 秒内无法获取 IDE 状态。 可能是 IDE 后端卡住了  |      * 后端服务器的 shell 是交互式的，或有配置错误，因此部署命令未能正确完成。 请尝试用默认 config 或简单的 bash 替换它    * 后台 IDE 由于资源不足而挂起并且没有响应: 1. 通过 ssh 进入远程服务器并手动终止 IDE 进程。 2. 通过编辑 JVM 选项文件向远程 IDE 添加内存。 默认部署设置可能不适合普通或大型项目。 3. 查找远程 IDE JVM 设置文件： `$IDE_BIN_DIR/${IDE_PRODUCT_VM_OPTIONS}.vmoptions` 请查看以下示例： `./.cache/JetBrains/RemoteDev/dist/a17ad99f7faf8_ideaIU-2021.3.1/bin/idea64.vmoptions` 4. 编辑 `-Xmx` 值并使用新设置重复部署/连接    * 后端 IDE 无法处理您的项目（资源不足、配置错误、依赖项损坏）。 通过 ssh 进入远程服务器并按照 [此页面](https://www.jetbrains.com/zh-cn/help/idea/2022.1/remote-development-a.html#use_idea)的描述手动启动项目并检查输出。 如果项目成功启动，复制生成的链接并尝试从本地 Gateway 连接（文章中也有描述）。    |
|  CPU 或资源使用情况异常  |      * 为诊断性能问题，支持团队需要日志 （帮助 -> 收集主机和客户端日志） 、来自服务器的 CPU 快照 （帮助 -> 诊断工具 -> 开始 CPU 使用情况分析） ，以及堆转储（例如 `java_error_in_idea*.hprof` 这样的文件）。 如需了解有关诊断性能问题的更多信息，请参阅 [报告性能问题](https://intellij-support.jetbrains.com/hc/en-us/articles/207241235-Reporting-performance-problems)    |
|  IDE 卡住且无响应  |      * 当 IDE 挂起且无响应，导致无法使用菜单捕获快照时，请向我们提供 [线程转储文件](https://intellij-support.jetbrains.com/hc/en-us/articles/206544899)    |
|  远程 IDE 工作正常但停止响应  |      * 进入远程服务器并终止 IDE 进程或重启服务器，然后重新测试。    |

## 收集日志和提交报告

如果以上解决方案无效，且您需要我们的协助，请提供详细描述。 除了 IDE 版本、日志和线程转储（这是必须的）外，我们还希望提供代码/项目示例、屏幕截图或展示问题的 screencast/gif。

在提交报告时将它们附加到 [您的问题](https://youtrack.jetbrains.com/newIssue?project=CWM&c=Remote%20Context%20Remote%20Development)。

若要仅使 JetBrains 团队可见该问题，您可以将其可见性设置为   jetbrains团队  组。 除图片外，所有附件默认仅对 JetBrains 团队可见。

Procedure: 从 UI 收集日志

> **Note:**
> 要从后端 IDE 收集日志，JetBrains Gateway 或 IDE 必须连接到远程服务器。 如果未连接，它只能获取本地日志。

1. 来自 JetBrains Gateway  ：欢迎（启动）屏幕 - 左下角 - 齿轮图标 - “收集日志和诊断数据”。

2. 从您用作远程开发起点的主 IDE  ：顶部菜单 - “帮助” - “收集日志和诊断数据”。

3. 从启动的 JetBrains Client 会话  （已连接到远程服务器）：顶部菜单 - “帮助” - “收集主机和客户端日志”

Procedure: 手动收集日志

> **Note:**
> 如果界面冻结或连接丢失，请使用此方法。

1. 在本地工作站端  ：位置取决于您本地计算机的操作系统。

我们建议收集并发送 [IDE 使用的目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#logs-directory) 中的整个日志文件夹。

2. 在远程服务器上  ：日志分别位于每个 IDE 的安装文件夹中。

默认安装路径是  `~/.cache/JetBrains/<product><versions>/log/`

例如，  `~/.cache/JetBrains/IntelliJIdea2024.1/log/`

