Spring Boot中application.yaml配置Kafka证书绝对路径的问题

在Windows 10的Spring Boot项目中配置Kafka SSL证书路径时，以下几种错误配置都会导致文件找不到：

• 使用file:\\双反斜杠格式，报错路径语法不正确
• 直接用正斜杠绝对路径，Spring自动添加前置斜杠导致路径错误
• 使用file:C:/格式，因URI规范问题无法识别

可行的解决方案 #

方案1：正确转义的Windows绝对路径（带file前缀）

YAML中反斜杠需要双重转义，同时Java文件路径也需要转义，因此最终要使用四个反斜杠：

ssl:
  key-password: xxxx
  keystore-location: 'file:\\\\C:\\\\Users\\\\xx\\\\Downloads\\\\stores\\\\testclient.jks'
  keystore-password: dmlnvba
  truststore-location: 'file:\\\\C:\\\\Users\\\\xx\\\\Downloads\\\\stores\\\\truststore.jks'
  truststore-password: xxxxx

方案2：类路径相对路径（推荐，无平台依赖）

如果将证书放在项目的src/main/resources/certs目录下，直接使用classpath:前缀：

ssl:
  key-password: xxxx
  keystore-location: 'classpath:certs/testclient.jks'
  keystore-password: dmlnvba
  truststore-location: 'classpath:certs/truststore.jks'
  truststore-password: xxxxx

方案3：符合URI规范的正斜杠路径

file:前缀后添加单个斜杠，再跟盘符和正斜杠路径：

ssl:
  key-password: xxxx
  keystore-location: 'file:/C:/Users/xx/Downloads/stores/testclient.jks'
  keystore-password: dmlnvba
  truststore-location: 'file:/C:/Users/xx/Downloads/stores/truststore.jks'
  truststore-password: xxxxx

错误原因说明 #

1. 第一次配置错误：YAML中反斜杠未正确转义，导致Java接收到的路径格式不符合Windows文件系统规范
2. 第二次配置错误：无前缀的路径会被Spring识别为Web应用内部资源，自动添加前置斜杠，将绝对路径转为相对应用的路径
3. 第三次配置错误：file:C:/不符合URI规范，正确的文件URI格式应为file:/C:/...，缺少第一个斜杠导致无法解析为绝对文件路径

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