Spring Boot 3.5本地禁用OpenTelemetry Exporter仍报错的解决办法

1. 补全禁用配置项 #

确保application-local.yaml覆盖所有OTel相关的启用开关，包括日志、指标、链路追踪的导出配置：

opentelemetry:
  sdk:
    enabled: false
  instrumentation:
    enabled: false
  exporter:
    otlp:
      enabled: false
      logs:
        enabled: false
      metrics:
        enabled: false
      traces:
        enabled: false
logging:
  opentelemetry:
    enabled: false
management:
  opentelemetry:
    enabled: false
  tracing:
    enabled: false
  metrics:
    export:
      otlp:
        enabled: false

2. 排除OTel自动配置类 #

在Spring Boot启动类上显式排除相关自动配置类，避免配置未完全覆盖时自动生效：

import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.actuate.autoconfigure.tracing.opentelemetry.OpenTelemetryAutoConfiguration;
import org.springframework.boot.actuate.autoconfigure.metrics.export.otlp.OtlpMetricsExportAutoConfiguration;
import org.springframework.boot.actuate.autoconfigure.tracing.opentelemetry.OtlpTracingExportAutoConfiguration;
import org.springframework.boot.actuate.autoconfigure.logging.otlp.OtlpLogsExportAutoConfiguration;

@SpringBootApplication(exclude = {
    OpenTelemetryAutoConfiguration.class,
    OtlpMetricsExportAutoConfiguration.class,
    OtlpTracingExportAutoConfiguration.class,
    OtlpLogsExportAutoConfiguration.class,
    OpenTelemetryMetricsAutoConfiguration.class,
    OpenTelemetryTracingAutoConfiguration.class
})
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

3. 检查并排除间接依赖 #

使用依赖分析工具排查是否有第三方依赖间接引入了OTel日志导出组件：

• Maven：执行mvn dependency:tree | grep opentelemetry，找到如opentelemetry-exporter-otlp-http-logs、opentelemetry-sdk-logs等依赖，在对应父依赖中排除：

  <dependency>
      <groupId>com.example</groupId>
      <artifactId>problem-dependency</artifactId>
      <exclusions>
          <exclusion>
              <groupId>io.opentelemetry</groupId>
              <artifactId>opentelemetry-exporter-otlp-http-logs</artifactId>
          </exclusion>
          <exclusion>
              <groupId>io.opentelemetry</groupId>
              <artifactId>opentelemetry-sdk-logs</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• Gradle：执行./gradlew dependencies | grep opentelemetry，找到目标依赖后在build.gradle中排除：

  implementation('com.example:problem-dependency') {
      exclude group: 'io.opentelemetry', module: 'opentelemetry-exporter-otlp-http-logs'
      exclude group: 'io.opentelemetry', module: 'opentelemetry-sdk-logs'
  }
  

4. 检查日志框架配置 #

确认Logback/Log4j2的配置文件中没有残留OTel相关的Appender：

• Logback：删除logback-spring.xml中类似如下的配置：

  <appender name="OTEL" class="io.opentelemetry.instrumentation.logback.appender.v1_0.OpenTelemetryAppender"/>
  <root level="info">
      <appender-ref ref="OTEL"/>
  </root>
  

• Log4j2：删除log4j2-spring.xml中类似如下的配置：

  <Appenders>
      <OpenTelemetry name="OTEL"/>
  </Appenders>
  <Root level="info">
      <AppenderRef ref="OTEL"/>
  </Root>
  

5. 清除环境变量干扰 #

检查本地环境是否存在OTel相关的环境变量（如OTEL_EXPORTER_OTLP_ENDPOINT、OTEL_LOGS_EXPORTER），这些变量会优先于配置文件生效，需删除或重置。

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