添加AWS XRay Spring SDK至Spring Boot服务启动时遇Bean创建错误

我之前也碰到过一模一样的问题，大概率是AWS XRay SDK和Spring Boot的Micrometer依赖冲突导致的——XRay的自动插桩逻辑会干扰meterRegistryPostProcessor这个Bean的初始化流程。下面给你几个可行的解决思路：

1. 排除冲突的Micrometer依赖 #

XRay的Spring SDK可能自带了旧版本的Micrometer核心库，和你项目中Spring Boot自带的版本不兼容。你可以在依赖声明里排除掉XRay带来的Micrometer依赖：

Maven 配置 #

<dependency>
    <groupId>com.amazonaws</groupId>
    <artifactId>aws-xray-recorder-sdk-spring</artifactId>
    <version>你的SDK版本号</version>
    <exclusions>
        <exclusion>
            <groupId>io.micrometer</groupId>
            <artifactId>micrometer-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle 配置 #

implementation('com.amazonaws:aws-xray-recorder-sdk-spring:你的SDK版本号') {
    exclude group: 'io.micrometer', module: 'micrometer-core'
}

2. 禁用XRay自动插桩，手动配置组件 #

如果自动插桩是问题根源，你可以先关闭自动配置，然后手动注册需要的XRay组件，避免它干扰Spring的Bean创建流程：

在application.properties中添加：

spring.xray.enabled=false

然后根据你的业务需求，手动注册XRay的核心Bean，比如：

@Configuration
public class XRayConfig {
    @Bean
    public Filter tracingFilter() {
        return new AWSXRayServletFilter("你的服务名称");
    }

    @Bean
    public RestTemplate xRayRestTemplate() {
        return new XRayRestTemplate();
    }
}

3. 对齐Spring Boot和XRay SDK的版本兼容性 #

不同版本的Spring Boot和XRay SDK可能存在兼容问题，比如Spring Boot 2.7+建议搭配XRay SDK 2.12.0及以上版本，这些版本修复了和Micrometer的兼容Bug。你可以检查一下你的依赖版本，升级到匹配的组合。

另外，建议你查看完整的堆栈跟踪日志——你提供的日志只显示了开头部分，完整的堆栈应该会明确指出冲突的具体原因（比如类找不到、方法签名不匹配等），这能帮你更快定位问题。

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