IntelliJ IDEA
 
2023.2
快捷方式：Windows
获取 IntelliJ IDEA
  1. 远程开发
  2. 故障排除

故障排除

最后修改时间：2023 年 8 月 24 日

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

笔记

确保您已了解我们文档的系统要求和常见问题解答部分。

设置

问题

回答

Toolbox 中的 JetBrains Gateway、单独下载的 JetBrains Gateway 和 IDE 中的 JetBrains Gateway 之间有区别吗？

独立 JetBrains Gateway 支持“在 IDE 中打开”您的基于 Space 的项目的选项。如果您不使用它，则安装程序和工作流程没有其他差异。

检查安装场景。

我可以将远程开发指向远程服务器上的现有 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 尝试连接但失败。凭证 100% 正确。

  • 确保远程服务器上的AllowТcpForwardinginsshd_config已启用，因为需要将远程 IDE 进程的流量重定向到本地计算机。

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

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

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

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

  • 您上传了社区版本的存档。远程开发可用于付费版本。

上传远程开发人员失败并显示“退出代码：139 (SIGSEGV)”

如果远程计算机的操作系统是 RHEL、CentOS、RockyLinux - 检查系统日志中是否有 SELinux 警告或禁用 SELinux 并重试安装

在本地计算机上，该过程失败并出现“无法下载 JetBrains 客户端”错误

您的本地计算机必须具有到以下 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 输入远程服务器并按照本页所述手动启动项目并检查输出。

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

CPU或资源使用看起来异常

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

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

IDE 挂起并且没有响应

  • 当 IDE 挂起且没有响应，导致您无法使用菜单捕获快照时，请向我们提供线程转储

远程 IDE 工作但停止响应

  • 进入远程服务器并终止IDE进程或重新启动服务器，然后重新测试。在未来的版本中，我们计划支持自愈重启。

收集日志并提交报告

如果上述解决方案没有帮助，并且您需要我们的帮助，请提供详细说明。除了必须提供的 IDE 版本、日志和线程转储之外，我们还感谢能够说明问题的代码/项目示例、屏幕截图或截屏视频/gif。

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

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

从 UI 收集日志

笔记

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

  1. 从 JetBrains Gateway：欢迎（开始）屏幕 - 左下角 - 齿轮图标 - “收集所有日志”。

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

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

手动收集日志

笔记

如果 UI 冻结或连接丢失，请使用此方法。

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

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

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

    默认安装路径是~/.cache/JetBrains/RemoteDev-IDE_NAME/PROJECT_PATH/log

    例如，~/.cache/JetBrains/RemoteDev-IU/_home_ec2-user_intellij-samples/log/