SpringBoot打包FatJar后无法加载Kafka PlainLoginModule求助

问题根源 #

问题核心出在类加载器的差异上：

• javax.security.auth.login.LoginContext是JDK核心类，由Bootstrap类加载器加载，它默认会使用系统类加载器查找LoginModule实现类。
• SpringBoot FatJar采用嵌套Jar结构，所有依赖包都放在BOOT-INF/lib下，由Spring自定义的LaunchedURLClassLoader加载。系统类加载器无法访问这个自定义类加载器中的类——哪怕你的Jar里确实包含kafka-clients，也会出现加载失败。
• 而./gradlew bootRun启动时，Gradle会把所有依赖直接放到应用的classpath中，使用普通的应用类加载器，系统类加载器和应用类加载器层级关联，所以能正常找到类。

解决方案 #

1. 强制设置线程上下文类加载器 #

在你的SpringBoot启动类的main方法开头，添加一行代码，把当前线程的上下文类加载器设置为应用类加载器——LoginContext会优先使用这个类加载器查找类：

@SpringBootApplication
public class YourKafkaApplication {
    public static void main(String[] args) {
        // 先设置上下文类加载器
        Thread.currentThread().setContextClassLoader(YourKafkaApplication.class.getClassLoader());
        SpringApplication.run(YourKafkaApplication.class, args);
    }
}

2. 验证Gradle打包配置 #

确认你的Gradle配置没有错误排除kafka-clients，并且Spring Boot插件正确打包了依赖：

plugins {
    id 'org.springframework.boot' version '3.0.1'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

dependencies {
    implementation 'org.springframework.kafka:spring-kafka:3.0.1'
    // 其他业务依赖...
}

// 确保bootJar没有排除kafka-clients的配置
bootJar {
    // 移除任何类似 exclude group: 'org.apache.kafka' 的配置
}

打包后可以解压FatJar，检查BOOT-INF/lib下是否存在kafka-clients-3.3.1.jar，并确认该Jar内部包含org/apache/kafka/common/security/plain/PlainLoginModule.class。

3. 启动时指定JVM参数（备选） #

如果不想修改代码，可以在启动Jar时添加JVM参数，指定LoginModule使用的类加载器：

java -Djava.security.auth.login.module.class.loader=com.example.YourKafkaApplication -jar fatjar.jar

不过这种方式不如代码设置上下文类加载器可靠，因为部分环境可能会限制系统参数的设置。

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