Minecraft项目中SLF4J加载StaticLoggerBinder失败致HikariCP异常求助

嘿，我之前开发Minecraft插件的时候也碰到过一模一样的问题，折腾了快一下午才搞定，给你分享几个亲测有效的解决思路：

首先先明确问题根源——你看到的这些日志：

25.04 21:35:26 [Server] WARN SLF4J: Failed to load class "org.slf4j.impl.StaticLoggerBinder"。
25.04 21:35:26 [Server] WARN SLF4J: Defaulting to no-operation (NOP) logger implementation。
25.04 21:35:26 [Server] WARN SLF4J: See http://www.slf4j.org/codes.html#StaticLoggerBinder for further...

这是因为HikariCP依赖SLF4J日志框架，但你的项目里只装了SLF4J的API，没配对应的日志实现，所以SLF4J只能用无操作的NOP模式——虽然不会直接导致崩溃，但HikariCP的连接日志全被屏蔽了，调试起来巨难受。

下面是几个针对性的解决办法，你可以根据自己的项目构建工具（Maven/Gradle）和框架（Spigot/Paper/Fabric）选择：

1. 补全SLF4J的基础日志实现 #

最直接的方式是给项目加一个SLF4J的日志实现，比如slf4j-jdk14，它会把日志输出到JDK自带的日志系统里，和Minecraft服务器兼容性还不错：

• Maven：在pom.xml里添加依赖

<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-jdk14</artifactId>
    <version>1.7.36</version> <!-- 版本要和HikariCP依赖的SLF4J一致！比如HikariCP 4.x用1.7.x，5.x用2.x -->
    <scope>runtime</scope>
</dependency>

• Gradle：在build.gradle里添加

runtimeOnly 'org.slf4j:slf4j-jdk14:1.7.36'

2. 用Minecraft专用的SLF4J桥接器 #

如果是Spigot/Paper这类插件项目，更推荐用专门的桥接器，把SLF4J日志转发到Minecraft自带的Tinylog系统里，日志格式会和服务器日志统一，看着舒服：

• Maven

<dependency>
    <groupId>net.minecrell</groupId>
    <artifactId>slf4j-tinylog</artifactId>
    <version>1.7.36</version>
    <scope>runtime</scope>
</dependency>

• Gradle

runtimeOnly 'net.minecrell:slf4j-tinylog:1.7.36'

3. 排除冲突的SLF4J依赖 #

有时候你的项目里可能有其他依赖引入了不同版本的SLF4J，或者服务器本身已经自带了SLF4J实现，这时候可以排除HikariCP自带的SLF4J依赖，避免版本冲突：

• Maven

<dependency>
    <groupId>com.zaxxer</groupId>
    <artifactId>HikariCP</artifactId>
    <version>4.0.3</version> <!-- 替换成你用的HikariCP版本 -->
    <exclusions>
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
        </exclusion>
    </exclusions>
</dependency>

• Gradle

implementation('com.zaxxer:HikariCP:4.0.3') {
    exclude group: 'org.slf4j', module: 'slf4j-api'
}

关键提醒：版本匹配很重要！ #

一定要检查HikariCP依赖的SLF4J版本，比如HikariCP 4.x系列依赖SLF4J 1.7.x，5.x系列依赖SLF4J 2.x，版本不匹配肯定会出问题。你可以用以下命令查看项目的依赖树，找出冲突：

• Maven：mvn dependency:tree
• Gradle：gradle dependencies

如果还是不行，就检查一下你的打包配置，比如插件是否把依赖正确打进了jar包，或者有没有服务器的类路径限制（比如有些服务器不允许插件自带SLF4J，这时候就得用桥接器或者排除依赖）。

内容的提问来源于stack exchange，提问作者Randstad