Spring Boot 3.3.x集成Spring Data Solr出现ClassCastException求助

问题根源
Spring Boot 3.3.x默认依赖Spring Data Commons 3.3.x，该版本对仓库查询参数的实现做了变更：org.springframework.data.repository.query.DefaultParameters不再与org.springframework.data.solr.repository.query.SolrParameters存在继承/实现关系，而停止维护的Spring Data Solr 4.3.15仍在强制类型转换这两个类，导致抛出ClassCastException。

可行解决方案 #

1. 临时回退到Spring Boot 3.2.x版本 #

直接将Spring Boot版本锁定为3.2.9（或该系列的最新补丁版），保持与Spring Data Solr 4.3.15的兼容性。这是最快恢复业务的方案，但仅作为临时过渡，因为Spring Boot 3.2.x的维护周期有限。

2. 自定义修复Spring Data Solr的兼容性代码 #

由于Spring Data Solr已停止维护，无法等待官方补丁，可通过以下步骤自定义修复：

• 复制Spring Data Solr源码中的SolrQueryMethod类到你的项目中（包路径保持与原类一致：org.springframework.data.solr.repository.query）
• 修改getParameters()方法，移除强制类型转换，适配Spring Data Commons 3.3.x的参数结构：

@Override
public SolrParameters getParameters() {
    Parameters baseParameters = super.getParameters();
    
    // 如果是旧版本兼容的SolrParameters直接返回
    if (baseParameters instanceof SolrParameters) {
        return (SolrParameters) baseParameters;
    }
    
    // 针对DefaultParameters构造新的SolrParameters实例
    SolrParameters solrParameters = new SolrParameters();
    for (Parameter parameter : baseParameters) {
        solrParameters.addParameter(parameter);
    }
    return solrParameters;
}

• 同步检查并调整SolrParametersParameterAccessor的构造方法，确保能接收新的参数类型
• 利用类加载优先级，让项目中的自定义类覆盖原Spring Data Solr jar中的类

3. 长期方案：迁移到Solr官方客户端或替代方案 #

Spring Data Solr已停止维护（最后版本为4.3.x，对应Spring Boot 3.2.x），长远来看必须迁移：

• 使用SolrJ直接操作：采用Solr官方提供的SolrJ客户端，完全控制Solr的查询、更新等操作，摆脱Spring Data的依赖限制
• 迁移到替代搜索引擎：如果业务允许，考虑迁移到Elasticsearch等仍活跃维护的搜索引擎，配合Spring Data Elasticsearch使用

内容的提问来源于stack exchange，提问作者thomas.schuerger