问题：如何解决Minecraft服务器启动时出现的Internal Exception: com.google.common.util.concurrent错误？

Question

在运行Minecraft服务器时，启动失败并抛出“Internal Exception: com.google.common.util.concurrent”错误通常是由于Guava库版本不兼容所致。该问题常见于服务端核心文件（如Paper、Spigot或Forge）与Java版本或插件依赖的Guava版本冲突。 解决方法包括： 1. **确认Guava版本**：检查服务端jar是否使用了正确版本的Guava库，必要时手动替换lib目录下的guava包。 2. **更新JDK版本**：部分旧版Minecraft服务端不支持高版本Java，建议使用JDK 8或适配服务端版本的运行环境。 3. **检查插件兼容性**：禁用可能依赖旧版Guava的插件，或联系开发者获取更新版本。 4. **重新下载核心jar文件**：确保服务端jar未损坏或被篡改。 通过上述步骤，可有效修复因Guava引发的启动异常，使服务器正常运行。

Answer 1

一、问题背景与定位

Minecraft服务器在启动过程中，若抛出“Internal Exception: com.google.common.util.concurrent”异常，通常表明Guava库版本不兼容。该类异常多见于服务端核心文件（如 Paper、Spigot 或 Forge）与其运行时依赖的 Java 版本或插件所引用的 Guava 库之间存在冲突。

1. 异常现象描述

• 服务端无法正常启动
• 日志中出现如下关键错误信息：

Internal Exception: java.lang.NoClassDefFoundError: com/google/common/util/concurrent/MoreExecutors

或类似异常堆栈跟踪。

2. Guava 简介及其作用

Guava 是 Google 提供的一组 Java 核心库，包含集合、缓存、并发工具等模块。Minecraft 服务端和部分插件依赖特定版本的 Guava 来实现异步任务调度等功能。

二、问题分析过程

要解决此类问题，需从以下几个方面进行系统性排查：

1. 检查 Guava 版本是否匹配

不同版本的 Minecraft 服务端（如 Paper、Spigot）可能绑定不同版本的 Guava。例如：

服务端类型	推荐 Guava 版本
Paper 1.16.x	Guava 21.0
Paper 1.18.x	Guava 30.1.1-jre
Forge 1.19.2	Guava 31.1.0-jre

2. 查看当前 Java 版本是否适配

某些旧版服务端（如 Spigot 1.12）仅支持 JDK 8，而高版本 Guava 可能需要更高版本的 Java 支持，导致 ClassLoader 加载失败。

java -version

建议使用以下命令查看具体版本信息：

javac -version

3. 插件对 Guava 的依赖分析

部分插件可能自带 Guava 依赖，且版本与服务端不一致，造成冲突。可通过反编译插件 JAR 文件或使用 Maven/Gradle 构建配置查看其依赖树。

三、解决方案详解

1. 手动替换 Guava 包

步骤如下：

1. 关闭服务器并备份当前配置
2. 进入服务端 lib 目录，删除旧 Guava jar 文件
3. 下载对应版本的 Guava 包（如 guava-30.1.1-jre.jar）
4. 将其放入 lib 并重启服务端

2. 更换合适的 JDK 版本

如果服务端为老版本，建议使用 JDK 8：

sdk use java 8.0.302.hs-adpt

对于新版本服务端，可尝试使用 JDK 17 或 21，并确保 Guava 兼容。

3. 插件兼容性处理流程

可通过以下流程图判断插件是否引发冲突：

graph TD
            A[启动失败] --> B{是否存在异常Guava调用?}
            B -- 是 --> C[检查插件依赖]
            C --> D[禁用可疑插件]
            D --> E[重新启动测试]
            E -- 成功 --> F[确认插件为冲突源]
            E -- 失败 --> G[继续排查其他插件]
            B -- 否 --> H[检查服务端jar完整性]

4. 重新获取服务端核心 jar 文件

若怀疑 jar 文件损坏或被篡改，建议从官方渠道重新下载，如：

• PaperMC 官网
• SpigotMC
• Forge 官方发布页

四、扩展思考：构建稳定 Minecraft 服务端环境

为避免此类问题反复发生，建议采取以下措施：

• 统一管理所有插件的依赖版本
• 使用构建工具（如 Gradle）自动解析依赖冲突
• 定期更新服务端与插件至最新稳定版本
• 部署前进行本地测试环境验证