Spring Boot升级2.6.8启动报SimpleElasticsearchRepository实例化失败

该错误和自定义Repository代码无关，是Spring Boot 2.4.2升级到2.6.8时，连带升级的Spring Data Elasticsearch版本（从4.1.x升级到4.3.x）调整了索引名SpEL解析逻辑导致的：

• 2.4.x版本对索引名解析的空值容错性较高，当@Document注解上配置的indexNameSpEL表达式解析返回null时，会走默认降级逻辑，不会抛出异常
• 2.6.x版本收紧了解析逻辑，当解析索引名得到null值时，框架内部会直接对该null值调用substring()方法做索引名格式处理，最终抛出SpelEvaluationException: EL1011E错误
• 绝大多数场景下，问题根源是Elasticsearch实体类MyObject上的@Document注解配置存在问题：要么是SpEL表达式写法错误（比如引用配置项的路径不对、漏写SpEL包裹标记），要么是表达式依赖的配置/Bean在Repository初始化阶段还未完成加载，导致解析结果为null。

• 第一步：定位实体类配置问题
  打开MyObject类，检查类上的@Document注解：
  • 如果是硬编码索引名，检查是否存在误写的残缺SpEL标记（比如多余的#{}符号）
  • 如果是动态读取配置的索引名，修正SpEL写法，确保表达式可在启动阶段正常解析出非空值，标准配置示例：

    import org.springframework.data.elasticsearch.annotations.Document;
    
    // 确保引用的配置项elasticsearch.index.my-object在配置文件中存在非空值
    @Document(indexName = "#{@environment.getProperty('elasticsearch.index.my-object')}")
    public class MyObject {
        // 实体字段省略
    }
    

  • 快速验证方式：临时将indexName改为固定硬编码字符串，若应用能正常启动，即可确认是索引名SpEL解析的配置问题。
• 第二步：增加解析兜底逻辑（兼容特殊场景）
  若业务场景必须保留原有动态索引表达式，可自定义索引名解析器增加空值兜底，避免框架直接对null值调用方法：

  import org.springframework.context.annotation.Bean;
  import org.springframework.context.annotation.Configuration;
  import org.springframework.data.elasticsearch.core.ElasticsearchMappingContext;
  import org.springframework.data.elasticsearch.core.IndexNameExpressionResolver;
  import org.springframework.expression.EvaluationContext;
  import org.springframework.expression.ExpressionParser;
  
  @Configuration
  public class ElasticsearchConfig {
      @Bean
      public ElasticsearchMappingContext elasticsearchMappingContext() {
          ElasticsearchMappingContext context = new ElasticsearchMappingContext();
          context.setIndexNameExpressionResolver(new IndexNameExpressionResolver() {
              @Override
              public String resolve(ExpressionParser parser, EvaluationContext context, String expression) {
                  Object parseResult = parser.parseExpression(expression).getValue(context);
                  // 解析结果为空时返回默认兜底索引名，可根据业务调整
                  return parseResult != null ? parseResult.toString() : "default-index";
              }
          });
          return context;
      }
  }
  

• 第三步：排除版本依赖冲突
  如果上述调整后仍报错，检查项目maven/gradle依赖，确认没有手动指定低版本的Spring Data Elasticsearch依赖，确保版本和Spring Boot 2.6.8默认绑定的版本一致。

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