SpringBoot Kafka自动配置异常：密钥库路径被WAR解压目录前缀拼接

原因分析 #

Spring Kafka自动配置处理spring.kafka.ssl.key-store-location时，会通过Spring的ResourceLoader解析路径。在Tomcat部署WAR包的场景下，ResourceLoader默认将WEB应用根目录（即/opt/app/webapps/ROOT）作为资源根路径。即便你的路径看起来是绝对路径（以/开头），只要没明确指定资源协议（如file:），ResourceLoader仍会把它当成相对应用根目录的路径，自动拼接前缀后生成错误路径。

而你通过@Value获取配置值时，只是直接读取字符串，不会经过ResourceLoader的解析逻辑，所以能得到正确的路径值。

解决方案 #

以下三种方式任选其一即可：

1. 配置文件添加file:协议前缀
   修改配置文件中的路径配置，明确指定为文件系统绝对路径：

spring.kafka.ssl.key-store-location=file:${javax.net.ssl.keyStore:}

2. JVM参数添加file:协议前缀
   启动Tomcat时，将JVM参数中的路径改为带协议的格式：

-Djavax.net.ssl.keyStore=file:/opt/app/config/keystore.jks

3. 自定义Kafka SSL配置绕过资源解析
   通过代码手动构建SSL配置，直接使用绝对路径文件，避开Spring自动配置的资源解析逻辑：

@Configuration
public class KafkaSslCustomConfig {
    @Value("${javax.net.ssl.keyStore}")
    private String keyStoreAbsolutePath;

    @Bean
    public KafkaProperties kafkaProperties() {
        KafkaProperties properties = new KafkaProperties();
        try {
            properties.getSsl().setKeyStoreLocation(new File(keyStoreAbsolutePath).toURI());
        } catch (URISyntaxException e) {
            throw new RuntimeException("Invalid keystore path", e);
        }
        // 如需其他SSL配置，可在此补充
        return properties;
    }
}

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