springboot3.3.5 集成elasticsearch8.12.2 ssl 通过 SSL bundle name 来实现

看到你在 Spring Boot 3.3.5 中配置 Elasticsearch 时遇到了 SSL bundle name 'es-ssl-bundle' cannot be found 的错误。这个问题通常是因为你在配置中指定了一个名为 es-ssl-bundle 的 SSL 捆绑包,但 Spring Boot 在它的上下文中并没有找到这个定义好的捆绑包。

简单来说,就是你告诉程序要用一个叫"es-ssl-bundle"的安全证书包,但是这个包要么还没创建,要么名字没对应上。

🔧 解决方案:配置 SSL Bundle

Spring Boot 3 引入了 SSL Bundles 的概念,它允许你集中管理 SSL 配置 ,包括信任材料(如证书、私钥)和各种 SSL 选项。你需要通过 application.yml (或 application.properties )明确定义一个名为 es-ssl-bundle 的 SSL 捆绑包,并指定证书的路径和类型。

以下是修改你的 application.yml 配置的示例:

yaml 复制代码
# application.yml

spring:
  elasticsearch:
    username: elastic
    password: -a_-nPO4EvwEqJhUnECH # 记得确保密码正确哦
    uris: https://192.168.8.140:9200
    restclient:
      ssl:
        bundle: es-ssl-bundle # 这里指向下面定义的 SSL Bundle 名称

# 配置 SSL Bundles
ssl:
  bundle:
    jks: # 你可以根据证书类型选择 jks, pem 或 pkcs12
      es-ssl-bundle: # 这是你在上面引用的 bundle 名称
        key:
          alias: "my-key-alias" # 如果你的密钥库有别名,请指定
          password: "your-keystore-password" # 密钥库的密码
        keystore:
          location: "classpath:elasticsearch/keystore.jks" # 你的 .jks 文件路径
          password: "your-keystore-password" # 密钥库的密码
          type: "JKS" # 密钥库类型,通常是 JKS 或 PKCS12
        truststore:
          location: "classpath:elasticsearch/truststore.jks" # 信任库路径(如果需要验证服务器证书)
          password: "your-truststore-password"

如果你的证书是 PEM 格式 (比如 .crt 和 .key 文件),配置会稍有不同:

yaml 复制代码
# 如果是 PEM 格式证书的配置示例
ssl:
  bundle:
    pem:
      es-ssl-bundle:
        key: # 配置客户端私钥(如果不是双向认证,可能不需要)
          alias: "my-key-alias" 
          password: "your-private-key-password" # 私钥的密码(如果有的话)
        keystore: 
          private-key: "classpath:elasticsearch/client.key" # 你的私钥文件路径
          certificate: "classpath:elasticsearch/client.crt" # 你的证书文件路径
        truststore: 
          certificate: "classpath:elasticsearch/ca.crt" # 你从ES服务器获取的CA证书路径

关键配置说明:

  • bundle 名称一致性 :确保 spring.elasticsearch.restclient.ssl.bundle 指定的名称(如 es-ssl-bundle)与在 ssl.bundle 下定义的名称完全一致。
  • 证书路径 :location 或 private-key/certificate 需要指向你确切的证书文件位置。请确保这些文件真的在你说的地方,并且文件名和扩展名都正确。
  • 密码 :如果你的密钥库、信任库或私钥设置了密码,必须提供正确的密码。
  • 证书类型 :根据你的证书文件的实际类型(JKS, PKCS12, PEM),在 ssl.bundle 下选择对应的配置节点(jks, pkcs12, pem)。

⚠️ 开发环境临时方案(不推荐用于生产)

如果只是为了在开发环境快速测试,你可以考虑暂时禁用 SSL 证书验证 。但这会降低连接的安全性,不适合生产环境。

yaml 复制代码
spring:
  elasticsearch:
    username: elastic
    password: -a_-nPO4EvwEqJhUnECH
    uris: https://192.168.8.140:9200
    # 移除或注释掉 restclient.ssl.bundle 配置
    # restclient:
    #   ssl:
    #     bundle: es-ssl-bundle
    ssl:
      verification-mode: none # 跳过证书验证(不安全!)

重要提醒 :verification-mode: none 只是权宜之计,一旦 SSL 捆绑包配置正确,就应该恢复使用捆绑包的方式。

💎 核心步骤总结

解决此问题的核心在于正确定义并在 Elasticsearch 配置中引用一个 SSL Bundle。为了帮你更清晰地理解这个流程,我为你梳理了以下的排查和解决步骤:
是 否 定义 Bundle 确定证书类型
JKS/PKCS12 或 PEM 在 application.yml 中
配置 ssl.bundle 段 确保证书文件路径正确 启动报错: SSL bundle not found 在 Elasticsearch 配置中
正确引用定义好的 bundle 名称 问题解决? 成功连接 检查证书内容/密码/路径

这样就可以了。

相关推荐
其实防守也摸鱼4 小时前
用 Claude Code 重构遗留系统:从评估到落地的完整指南
前端·网络·人工智能·chrome·安全·重构
优化Henry6 小时前
LTE 站点 S1 链路反复闪断导致小区频闪退服故障排查
运维·网络·学习·信息与通信·tdd
心之王者7166 小时前
Linux 进程信号:从产生、阻塞到捕捉与子进程回收
linux·服务器·网络
.痞老板.6 小时前
java ee--网络编程套接字
网络·java-ee·php
2401_868534786 小时前
逻辑网络设计
网络·python
岳涛7 小时前
考古|ES 0.90 的 _ttl 让文档到期自动删,2.0 起引擎只做引擎,5.0 清掉内置字段
elasticsearch
wuyk5557 小时前
Spider-第14讲-表单提交与CSRF
前端·爬虫·python·elasticsearch·csrf
岳涛9 小时前
时序|ES 9.1 存下写坏的文档,响应码从 400 变成 201,写入端仍当它成功
elasticsearch
如夏倾城9 小时前
BGP(Border Gateway Protocol 边界网关协议)
运维·服务器·网络·gateway·信息与通信
Elasticsearch11 小时前
九条 ES|QL 查询,揭示你的 Foundry agent 的词元消耗去向
elasticsearch