WebStorm 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 WebStorm-221.5591.52/bin/remote-dev-server.sh registerBackendLocationForGateway

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

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

为何在设置过程中 SSH 无法连接到远程服务器？

  • 远程服务器端或虚拟机提供商的防火墙阻止了传入连接。 在 AWS 的情况下，请勿忘记调整“安全组”设置

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

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

JetBrains Gateway 卡在 检索 IDE 版本 步骤，无法加载可用的 IDE

JetBrains Gateway 尝试连接但失败。凭据是 100% 正确的。 凭据是 100% 正确的。

  • 请确保远程服务器上的 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 后重试安装

在本地机器上，处理失败，错误为“无法下载 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 选项文件为远程 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 版本、日志和线程转储（必需项）外，我们欢迎提供代码／项目示例、截图或能体现问题的视频／动图。

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

若希望该问题仅对 JetBrains 团队可见，可以将其可见性设置为 jetbrains-team 组。 除图像外，所有附件默认仅对 JetBrains 团队可见。

从 UI 收集日志

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

  2. 来自用作远程开发起点的主 IDE ：顶部菜单中选择“帮助”→“收集日志和诊断数据”。

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

手动收集日志

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

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

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

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

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

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