RestTemplate未携带请求属性：父子服务调用属性传递失败咨询

核心误解：跨服务HTTP调用≠同一请求上下文 #

你之所以会觉得父服务的request属性能传递到子服务，大概率是把同一服务内的请求转发/跳转和跨服务的HTTP远程调用搞混了：

• 同一服务内的forward或者include，是在同一个Servlet容器的同一个请求线程里处理的，HttpServletRequest是同一个对象，所以设置的属性能直接拿到。
• 但用RestTemplate调用子服务时，本质是父服务作为HTTP客户端，向子服务发起了一个全新的HTTP请求。子服务接收到的是它自己容器生成的HttpServletRequest对象，和父服务的那个完全是两个独立的实例，自然拿不到父服务设置的key属性。

正确的参数传递方式 #

想要把父服务的信息传递到子服务，得通过HTTP协议允许的载体来传递，常见的几种方式：

1. 自定义请求头（推荐用于上下文信息）

如果是传递用户ID、链路追踪ID这类轻量的上下文信息，用请求头是最方便的：
父服务调用时添加请求头：

HttpHeaders headers = new HttpHeaders();
headers.set("X-Transfer-Key", "someValue"); // 自定义头，前缀X-是行业惯例
HttpEntity<Void> requestEntity = new HttpEntity<>(headers);
restTemplate.exchange(url, HttpMethod.GET, requestEntity, Object.class);

子服务中获取：

@GetMapping("/child-api")
public Object childApi(HttpServletRequest request) {
    String value = request.getHeader("X-Transfer-Key");
    // 后续业务处理逻辑
}

2. URL查询参数（适合简单参数）

如果参数是公开的、简单的，可以直接拼在URL里：
父服务调用：

String url = "http://child-service/api?key=someValue";
restTemplate.exchange(url, HttpMethod.GET, null, Object.class);

子服务中获取：

@GetMapping("/child-api")
public Object childApi(@RequestParam("key") String value) {
    // 后续业务处理逻辑
}

3. 请求体（适合复杂数据）

如果要传递的是复杂对象，建议用POST/PUT请求，把数据放在请求体里：
父服务调用：

Map<String, Object> body = new HashMap<>();
body.put("key", "someValue");
HttpEntity<Map<String, Object>> requestEntity = new HttpEntity<>(body);
restTemplate.exchange(url, HttpMethod.POST, requestEntity, Object.class);

子服务中获取：

@PostMapping("/child-api")
public Object childApi(@RequestBody Map<String, Object> body) {
    String value = (String) body.get("key");
    // 后续业务处理逻辑
}

4. 全局上下文传递（Spring Cloud场景）

如果是Spring Cloud微服务架构，想要统一传递上下文（比如用户信息、链路ID），可以实现ClientHttpRequestInterceptor，自动把父服务请求中的指定头信息复制到子服务的请求中，不用每次调用都手动加：

@Component
public class ContextTransferInterceptor implements ClientHttpRequestInterceptor {
    @Override
    public ClientHttpResponse intercept(HttpRequest request, byte[] body, ClientHttpRequestExecution execution) throws IOException {
        // 从父服务的当前请求中获取上下文信息
        ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        if (attributes != null) {
            HttpServletRequest parentRequest = attributes.getRequest();
            // 复制指定头到子服务请求中
            String traceId = parentRequest.getHeader("X-Trace-Id");
            if (traceId != null) {
                request.getHeaders().add("X-Trace-Id", traceId);
            }
        }
        return execution.execute(request, body);
    }
}

然后把这个拦截器加到RestTemplate里：

@Bean
public RestTemplate restTemplate(ContextTransferInterceptor interceptor) {
    RestTemplate restTemplate = new RestTemplate();
    restTemplate.getInterceptors().add(interceptor);
    return restTemplate;
}

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