Eclipse 在 Fedora 报 Exit Code 13？快速修复启动失败问题

搞定 Eclipse 在 Fedora 上的 "Exit Code 13" 启动失败 (OpenJDK 环境)

刚装好的 Fedora 22，用 dnf 装了个 Eclipse，想着终于可以开工了，结果一启动就给我撂挑子，报了个 "JVM terminated. Exit code=13" 的错。真是头疼，网上搜了两天也没找到靠谱的法子。看这错误信息，八成跟 JVM 配置或者路径有点关系。

JVM terminated. Exit code=13
/usr/bin/java
-Xms128m
-Xmx1024m
# ... (省略一长串参数) ...
-vm /usr/bin/java
-vmargs
# ... (省略更多 VM 参数) ...
-jar /usr/lib64/eclipse//plugins/org.eclipse.equinox.launcher_1.3.0.v20150513-1800.jar

这信息挺明确，启动过程中 JVM 出错了，代码 13。下面那一堆都是启动时传给 JVM 的参数。自己检查了下，whereis java 指向 /usr/bin/java，也确认了 java -version 显示的是 OpenJDK 1.8.0_45。看起来 JDK 装得没毛病。

$ java -version
openjdk version "1.8.0_45"
OpenJDK Runtime Environment (build 1.8.0_45-b13)
OpenJDK Server VM (build 25.45-b02, mixed mode)

我也尝试编辑了 /etc/eclipse.ini 文件，加入了指定 JVM 路径的两行：

-vm
/usr/bin/java

但问题依旧。这到底是哪里不对劲呢？

为什么会冒出 Exit Code 13？

"Exit Code 13" 这个错误，在 Eclipse 启动失败的场景里，通常指向跟 Java 虚拟机 (JVM) 相关的问题。具体点说，可能的原因有：

1. JVM 路径配置错误 : Eclipse 启动器找不到你指定的 java 可执行文件，或者找到的不是它想要的那个。这可能是 eclipse.ini 文件里 -vm 参数设错了，或者根本没设。
2. JVM 版本或架构不兼容 : 你安装的 Eclipse 版本（比如 64 位）可能跟你系统里或者 eclipse.ini 文件里指定的 JVM 版本（比如 32 位，或者版本太老/太新）不匹配。
3. eclipse.ini 文件语法错误 : 文件里的参数格式不对，比如 -vm 和它的路径没分两行写，或者写在了 -vmargs 参数后面，都可能导致解析失败。
4. JVM 安装损坏 : 虽然不常见，但 JVM 本身安装不完整或者文件损坏了，也会导致启动失败。
5. 系统权限问题 : 运行 Eclipse 的用户对指定的 java 可执行文件没有执行权限。
6. Fedora 仓库打包问题 : 通过 dnf 安装的 Eclipse，其打包配置可能跟特定版本的 OpenJDK 存在一些不易察觉的冲突。

从错误日志看，Eclipse 确实尝试使用 /usr/bin/java 来启动。尽管用户确认了这个路径存在并且是 OpenJDK 8，问题还是发生了。这提示我们可能要更深入地检查配置细节或者考虑其他可能性。

动手解决：一步步排查

碰上这种问题，别急，咱们一步步来排查。下面提供几种常见的解决思路和操作步骤。

方案一：彻底检查并修正 eclipse.ini 配置

这是最常见的“肇事者”。即使你觉得已经配对了，也值得再仔细瞅瞅。

原理与作用：

eclipse.ini 文件是 Eclipse 启动器的配置文件。通过在这个文件里设置 -vm 参数，你可以明确告诉 Eclipse 使用哪个 Java 可执行文件来运行。正确的配置能确保 Eclipse 找到兼容且正确的 JVM。

操作步骤：

1. 定位 eclipse.ini 文件:
   通过 dnf 安装的 Eclipse，全局配置文件通常在 /etc/eclipse.ini。如果你是手动下载解压的，那它就在你解压出来的 Eclipse 文件夹根目录下。注意：编辑系统级别的 /etc/eclipse.ini 可能需要 sudo 权限。

2. 仔细检查 -vm 参数：

   • 确保 -vm 参数独占一行。
   • 紧接着的下一行，必须是 指向 java 可执行文件的完整绝对路径 ，而不是目录。
   • 最关键的一点：-vm 和它的路径这两行，必须出现在 -vmargs 参数之前 。如果放错了地方，Eclipse 启动器会忽略这个 -vm 设置，转而尝试自己寻找 JVM，这往往就容易出问题。

正确的 eclipse.ini 片段示例 (/etc/eclipse.ini)：

-startup
plugins/org.eclipse.equinox.launcher_1.3.0.v20150513-1800.jar
--launcher.library
plugins/org.eclipse.equinox.launcher.gtk.linux.x86_64_1.1.200.v20150513-1800
# --- 把 -vm 和路径加在这里 ---
-vm
/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.45-45.b13.fc22.x86_64/jre/bin/java  # <-- 注意！建议用绝对路径，见方案二
# --- 确保在 -vmargs 之前 ---
-vmargs
-Xms128m
-Xmx1024m
# ... 其他 vmargs 参数 ...
-Dorg.eclipse.swt.browser.UseWebKitGTK=true
# ...

安全建议：

修改系统配置文件 /etc/eclipse.ini 时，建议先备份一个原始版本，比如 sudo cp /etc/eclipse.ini /etc/eclipse.ini.bak。万一改错了，还能恢复。

进阶使用技巧：

有时候，即使路径对了，权限也可能有问题。可以确认一下指定的 java 文件是否有执行权限：ls -l /path/to/your/java。通常 OpenJDK 安装后权限是没问题的，但排查时可以顺带看看。

方案二：使用 JVM 的绝对路径替代系统链接

/usr/bin/java 通常是一个符号链接（symlink），由系统的 alternatives 机制管理，它指向实际的 Java 安装路径。虽然用这个链接一般没问题，但有时候，特别是涉及不同 Java 版本切换或者特定环境时，直接指定那个最终的 java 可执行文件的绝对路径会更稳妥。

原理与作用：

直接指定 Java 安装目录下的 bin/java 文件路径，绕过了符号链接可能带来的不确定性（比如链接配置错误、更新不同步等）。这让 Eclipse 启动器能百分百精确地找到目标 JVM。

操作步骤：

1. 找到 OpenJDK 的真实安装路径：

   • 可以通过 which java 找到链接路径：which java 输出 /usr/bin/java。
   • 然后用 readlink -f 追踪这个链接最终指向的真实文件：

     readlink -f $(which java)
     

     这会输出类似 /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.45-45.b13.fc22.x86_64/jre/bin/java 的路径。复制这个完整的路径。

2. 更新 eclipse.ini 文件：
   打开你的 eclipse.ini 文件 (通常是 /etc/eclipse.ini)，找到 -vm 参数下一行的路径，替换成上一步找到的那个绝对路径。

修改后的 eclipse.ini 片段 (/etc/eclipse.ini)：

# ... 其他参数 ...
-vm
/usr/lib/jvm/java-1.8.0-openjdk-1.8.0.45-45.b13.fc22.x86_64/jre/bin/java  # <-- 使用 readlink 找到的绝对路径
-vmargs
# ... 后续参数 ...

3. 保存文件并尝试重新启动 Eclipse。

方案三：确认 Eclipse 和 JVM 的架构匹配

虽然从错误日志看，x86_64 架构是明确的，但为了保险起见，确认一下总是好的。万一不小心装了个 32 位的 Eclipse 或者 JVM 呢？（在现代 Linux 发行版上概率很小，但排查嘛，就得全面点）。

原理与作用:

64 位的 Eclipse 必须使用 64 位的 JVM 来运行，反之亦然。如果架构不匹配，JVM 初始化就会失败，可能导致 Exit Code 13 或其他类似的错误。

操作步骤：

1. 检查 JVM 架构：
   使用 file 命令查看你打算使用的 java 可执行文件的架构信息。结合方案二找到的绝对路径：

   file $(readlink -f $(which java))
   

   或者直接用你找到的绝对路径：

   file /usr/lib/jvm/java-1.8.0-openjdk-1.8.0.45-45.b13.fc22.x86_64/jre/bin/java
   

   输出应该包含 64-bit LSB executable 或类似表明 64 位架构的信息。

2. 检查 Eclipse 架构：

   • 通过 dnf 安装的 Eclipse 包名通常会包含架构信息，例如 eclipse-platform-x86_64。你可以用 dnf info eclipse 或类似命令查看已安装包的详细信息。
   • 查看 Eclipse 启动器或相关库文件的路径，如错误日志里显示的 /usr/lib64/eclipse/... 和 ...gtk.linux.x86_64...，这些都强烈暗示 Eclipse 是 64 位版本。

如果两者架构不一致，你需要卸载错误架构的版本，然后安装匹配的版本。

方案四：绕开 DNF，尝试 Eclipse 官方安装包

有时候，Linux 发行版仓库里的软件包（通过 dnf、apt 等安装的）可能因为打包脚本、依赖关系处理或版本选择等原因，和某些系统环境或特定软件（比如这里的 OpenJDK）配合得不是特别好。

原理与作用:

直接从 Eclipse 官网下载最新的、适配你系统的安装包（通常是 .tar.gz 压缩文件），解压后独立运行。这样做的好处是：

• 版本最新/稳定 : 你可以选用 Eclipse 官方验证过的稳定版本。
• 环境隔离 : 它不依赖系统包管理器安装的那些可能产生冲突的库或配置，更加“纯净”。
• 配置灵活 : 它自带一个 eclipse.ini 文件，你可以直接编辑，方便指定 JVM，不受系统级配置干扰。

操作步骤:

1. 访问 Eclipse 官网 : 前往 www.eclipse.org/downloads/packages/。
2. 选择合适的包 : 根据你的开发需求（比如 Java、C/C++、Web 等）选择对应的 Eclipse IDE 包。注意选择 Linux x86_64 版本。下载 .tar.gz 文件。
3. 解压 : 找个你喜欢的地方（比如 ~/apps/ 或 /opt/），把下载的 .tar.gz 文件解压。

   mkdir -p ~/apps
   cd ~/apps
   tar -xzf /path/to/downloaded/eclipse-*.tar.gz
   

4. 配置 JVM (如果需要) :
   • 进入解压后的 eclipse 目录。
   • 编辑该目录下的 eclipse.ini 文件。
   • 按照方案一或方案二的方法，在 -vmargs 之前添加 -vm 和 JVM 的绝对路径 。如果你的系统默认 Java 就是你想要的 OpenJDK 8 且环境变量设置正确，这一步甚至可能都不需要，Eclipse 可能会自动找到它。但显式指定总是最稳妥的。
5. 运行 : 直接执行解压目录下的 eclipse 可执行文件。

   cd ~/apps/eclipse
   ./eclipse
   

6. （可选）创建桌面快捷方式 : 如果运行成功，可以自己创建一个 .desktop 文件放到 ~/.local/share/applications/，方便从桌面环境启动。

这种方法相当于绕开了 Fedora 的打包系统，直接使用上游版本，很多时候能有效解决因发行版特定配置引发的问题。

方案五：清理 Eclipse 缓存并尝试特殊启动参数

虽然 Exit Code 13 主要指向 JVM 问题，但偶尔，Eclipse 自身的缓存或持久化状态出问题也可能间接影响启动。使用 -clean 或 -clearPersistedState 参数启动可以清理这些潜在的“垃圾”。

原理与作用：

• -clean: 强制 Eclipse 清理其基于 OSGi 的运行时缓存。这可以解决一些插件或配置更新后残留的旧数据导致的问题。
• -clearPersistedState: 清除 Eclipse 保存的持久化 UI 状态和其他工作区相关的缓存信息。

操作步骤：

1. 打开终端。
2. 导航到 Eclipse 的安装目录 (如果是手动安装的话)，或者直接使用 eclipse 命令 (如果是 dnf 安装的系统路径)。
3. 尝试使用 -clean 参数启动：

   eclipse -clean
   

   如果是手动安装的，则是：

   /path/to/your/eclipse/executable -clean
   

4. 如果 -clean 不行，尝试 -clearPersistedState：

   eclipse -clearPersistedState
   

   或者：

   /path/to/your/eclipse/executable -clearPersistedState
   

注意 : 使用这些参数启动可能会比平时慢一些，因为它需要重建缓存。这更像是一个补充尝试，如果前面的方案都失败了，可以试试这个。

处理 Eclipse 的 "Exit Code 13" 错误，多半还是要从 eclipse.ini 文件下手，仔细核对 -vm 参数的路径、语法和位置。使用 JVM 的绝对路径通常能提高配置的稳定性。如果这些都不管用，或者你怀疑是 Fedora 包管理器的锅，那么直接下载官网的 Eclipse 包往往是个简单有效的解决办法。一步步来，总能把这玩意儿给搞定。