Java中Azure Application Insights Starter与Spring Boot 3.x.x兼容问题求助

问题原因 #

你使用的applicationinsights-spring-boot-starter:2.6.4是为Spring Boot 2.x开发的，依赖Java EE（javax.*）API；而Spring Boot 3.x已全面迁移至Jakarta EE（jakarta.*）API，两者包结构不兼容，导致框架无法自动创建TelemetryClient类型的Bean。

解决方案 #

1. 替换依赖包 #

在build.gradle中移除旧依赖，替换为适配Spring Boot 3.x的Azure Application Insights starter：

// 移除旧依赖
// implementation 'com.microsoft.azure:applicationinsights-spring-boot-starter:2.6.4'
// 添加新依赖
implementation 'com.azure.spring:azure-spring-boot-starter-applicationinsights:3.15.0'

注：3.15.0是当前适配Spring Boot 3的稳定版本，可根据官方发布选择最新兼容版本；也可通过引入Azure Spring Boot BOM来统一管理版本，避免冲突：

implementation platform('com.azure.spring:azure-spring-boot-bom:3.15.0')
implementation 'com.azure.spring:azure-spring-boot-starter-applicationinsights'

2. 确认TelemetryClient导入路径 #

新版starter中，TelemetryClient的包路径保持不变，依然是com.microsoft.applicationinsights.TelemetryClient，控制器注入代码无需修改，示例如下：

import com.microsoft.applicationinsights.TelemetryClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class DemoController {
    private final TelemetryClient telemetryClient;

    // 构造函数注入（推荐）
    public DemoController(TelemetryClient telemetryClient) {
        this.telemetryClient = telemetryClient;
    }

    @GetMapping("/track")
    public String trackEvent() {
        telemetryClient.trackEvent("Sample Event");
        return "Event tracked successfully";
    }
}

3. 连接字符串配置 #

仍可通过环境变量APPLICATIONINSIGHTS_CONNECTION_STRING配置，也可在application.properties或application.yml中显式配置：

azure.application-insights.connection-string=${APPLICATIONINSIGHTS_CONNECTION_STRING}

补充说明 #

• 旧版的applicationinsights.json配置文件仍可继续使用，需放置在src/main/resources目录下；
• 新版starter支持更多基于azure.application-insights.*前缀的配置项，可用于调整采样率、日志追踪规则等。

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