Spring微服务部署AWS Lambda，AWS X-Ray无法生成复合追踪问题

看起来你已经完成了X-Ray的基础配置，但跨服务的追踪链路关联还需要几个关键步骤补全，以下是最可能的原因和对应解决方法：

1. 核心缺失：X-Ray Servlet过滤器 #

仅引入依赖确实不足以实现跨服务追踪关联，你的Spring Lambda服务需要配置X-Ray Servlet过滤器——它的作用是提取传入请求中的X-Ray追踪头，将当前请求绑定到上游服务的trace上下文里。如果没有这个过滤器，服务A会把B的调用当作全新请求，生成独立的trace而非复合链路。

在Spring配置类中添加这个过滤器：

import com.amazonaws.xray.javax.servlet.AWSXRayServletFilter;
import org.springframework.boot.web.servlet.FilterRegistrationBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class XRayConfiguration {
    @Bean
    public FilterRegistrationBean<AWSXRayServletFilter> xRayServletFilter() {
        FilterRegistrationBean<AWSXRayServletFilter> filterBean = new FilterRegistrationBean<>();
        // 替换为你的服务标识，会显示在X-Ray控制台中
        filterBean.setFilter(new AWSXRayServletFilter("service-A"));
        filterBean.addUrlPatterns("/*");
        return filterBean;
    }
}

记得给服务B也添加同样的过滤器配置，确保双向的追踪上下文都能被正确处理。

2. 未使用X-Ray instrumentation的HTTP客户端 #

服务B调用A时，必须用X-Ray包装的HTTP客户端，它会自动在请求头中注入X-Amzn-Trace-Id，这样服务A才能识别到这是同一个trace的一部分。你已经引入了aws-xray-recorder-sdk-apache-http依赖，现在需要用对应的HttpClientBuilder创建客户端：

import com.amazonaws.xray.proxies.apache.http.HttpClientBuilder;
import org.apache.http.client.HttpClient;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class HttpClientConfig {
    @Bean
    public HttpClient xRayEnabledHttpClient() {
        return HttpClientBuilder.create().build();
    }
}

之后在服务B中使用这个HttpClient调用服务A的API，X-Ray会自动处理追踪头的传递工作。

3. 额外检查项 #

• 确认Lambda执行角色权限：你添加的AWSXrayWriteOnlyAccess权限足够发送trace数据，无需调整。
• 验证SAM的Tracing: Active配置：这个配置会让Lambda自动初始化X-Ray根segment，确保两个服务的SAM模板都正确设置了该属性。
• SDK版本兼容性：你使用的1.2.1版本是稳定版，若后续遇到问题，可以尝试升级到最新兼容版本（注意2.x系列与1.x的API差异）。

完成以上配置后，服务B调用A时，X-Ray就能将两个服务的trace关联起来，生成完整的复合追踪链路了。

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