GoLand 2025.2 Help

故障排除

远程开发 功能仍处于 JetBrains IDE 的积极开发阶段，可能会出现一些问题。 本页旨在帮助您在设置或后续使用过程中进行初步故障排除。

设置

问题

答案

来自 Toolbox 的 JetBrains Gateway、单独下载的版本或 IDE 自带的版本是否有区别？

独立版 JetBrains Gateway 支持将您的 基于 Space 的项目 “在 IDE 中打开”。如果不使用此功能，各安装程序及其使用流程无其他差异。

请查看 安装方案。

是否可以将 Remote Development 指向远程服务器上现有的 IDE？ 是否可以手动安装 IDE？

从版本 221.5481 开始，您可以手动注册远程服务器上的现有后端 IDE，并将其暴露给 JetBrains Gateway。 已安装的 IDE 将出现在可用构建列表中：

  1. 通过 SSH 进入远程服务器。

  2. 定位解压后的 IDE 文件夹，并进入 bin 文件夹。

  3. 在命令行中执行以下命令：

    remote-dev-server.sh registerBackendLocationForGateway

    例如，

    sh GoLand-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway

JetBrains Gateway 本身的安装未成功完成

  • 请确保您的系统用户拥有安装软件的权限，或联系您组织的系统管理员。

为什么在设置过程中 SSH 连接远程服务器失败？

  • 远程服务器端或虚拟机提供商的防火墙禁止传入连接。对于 AWS，请勿忘调整“安全组”设置。 在 AWS 场景中，请勿忘调整“安全组”

  • 远程端的 SSH 使用了非标准端口

  • 密码或密钥文件不正确，或由于多次失败连接已被阻止

JetBrains Gateway 卡在 获取 IDE 版本 步骤，未加载可用 IDE

JetBrains Gateway 尝试连接但失败。 凭据百分百正确。

  • 请确保远程服务器中的 AllowТcpForwarding 和 sshd_config 已启用，它们对于将远程 IDE 进程的流量重定向到本地机器是必需的。

我从本地机器选择 IDE 安装包，但上传过程失败

  • 远程服务器磁盘可用空间不足。 远程服务器上的可用空间必须至少为 4xIDE.tar.gz。

    从版本 2022.1.1 开始，您可以选择远程服务器上的自定义路径作为部署目标位置。

  • 您上传的不是 .tar.gz 安装包，因此无法在远程端解压

上传 remote-dev-worker 时失败，错误代码：“exit code: 139 (SIGSEGV)”

如果远程机器操作系统为 RHEL、CentOS 或 RockyLinux，请检查 用于 SELinux 警告的 syslog 或禁用 SELinux 并重试安装

本地机器上处理失败，错误为“Failed to download 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

或者，您可以配置 完全离线模式。

使用远程项目

问题

解答

在 60 秒内未能获取 IDE 状态。 IDE 后端可能已卡住

  • 后端服务器的 shell 是交互式的或存在配置错误，因此部署命令未正确完成。

    尝试将其替换为默认配置或简单的 bash

  • 后端 IDE 因资源不足而卡顿且无响应：

    1. 通过 ssh 登录远程服务器并手动终止 IDE 进程。

    2. 通过编辑 JVM options 文件为远程 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 登录远程服务器，并按照 此页面的说明手动启动项目并检查输出。

    如果项目成功启动，复制生成的链接并尝试从本地 Gateway 进行连接（文章中也有说明）。

CPU 或资源使用率异常

  • 要诊断性能问题，支持团队需要日志 （帮助 → 收集主机和客户端日志） 、服务器上的 CPU 快照 （帮助 → 诊断工具 → 启动 CPU 使用率分析） 和堆转储（例如文件 java_error_in_idea*.hprof）

    关于诊断性能问题的更多信息，请参阅 报告性能问题

IDE 卡顿且无响应

  • 当 IDE 卡顿且无响应、无法使用菜单捕获快照时，请提供 线程转储

远程 IDE 曾经正常，但现在无响应

  • 登录远程服务器并终止 IDE 进程或重启服务器，然后重新测试。

收集日志并提交报告

如果上述方案无效且您需要我们的协助，请提供详细说明。 除了必须提供的 IDE 版本、日志和线程转储外，我们还欢迎提供示例代码或项目、截图，或展示问题的 screencast/gif。

提交报告时，请将它们附加到 您的问题上。

要使问题仅对 JetBrains 团队可见，您可以将其可见性设置为 jetbrains-team 组。 默认情况下，除图像外，所有附件仅对 JetBrains 团队可见。

从 UI 收集日志

  1. 来自 JetBrains Gateway ：欢迎（启动）屏幕 — 左下角 — 齿轮图标 — “Collect Logs and Diagnostic Data”。

  2. 来自用作远程开发起点的主 IDE ：顶部菜单 — “Help” — “Collect Logs and Diagnostic Data”。

  3. 来自已启动的 JetBrains Client 会话 （已连接到您的远程服务器）：顶部菜单 — “Help” — “Collect Host and Client Logs”

手动收集日志

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

    建议从 IDE 使用的目录收集并发送整个日志文件夹。

  2. 在远程服务器上 ：日志根据 IDE 存放于其安装文件夹中。

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

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

最后修改日期： 2025年 9月 26日
远程开发常见问题解答许可和实用链接