SpringBoot集成OpenSearch启动时遇Jackson类缺失错误求助

问题根源 #

com.fasterxml.jackson.core.StreamWriteConstraints是Jackson 2.16.0及以上版本才新增的类，你的项目依赖的Jackson版本为2.15.x，而OpenSearch 2.12的客户端或starter组件中存在调用该类的代码，导致启动时触发NoClassDefFoundError。

解决方案 #

方案1：统一升级Jackson版本到兼容版 #

在pom.xml中通过依赖管理统一指定Jackson版本为2.16.x及以上（和OpenSearch 2.12客户端依赖的版本对齐）：

<properties>
    <jackson.version>2.16.1</jackson.version>
</properties>

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.fasterxml.jackson</groupId>
            <artifactId>jackson-bom</artifactId>
            <version>${jackson.version}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

方案2：升级OpenSearch Starter到适配SpringBoot3的版本 #

原OpenSearch Starter 1.3可能未适配SpringBoot3，替换为和OpenSearch服务端版本一致的2.x版本：

<!-- 替换原有starter依赖 -->
<dependency>
    <groupId>org.opensearch.client</groupId>
    <artifactId>spring-boot-starter-opensearch</artifactId>
    <version>2.12.0</version>
</dependency>

验证步骤 #

• 执行mvn clean install清理并重新构建项目
• 启动SpringBoot应用，检查是否仍出现类找不到的错误
• 确认OpenSearch服务端已禁用安全功能（opensearch.yml中配置plugins.security.disabled: true），避免连接时的额外异常

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