Spring Boot 3.0.1中HttpTraceRepository类缺失问题咨询

DevOps 小满

2026-8-4

问题解答

这是设计变更，并非Bug。

Spring Boot 3.0及以上版本中，HttpTraceRepository和InMemoryHttpTraceRepository已从Actuator模块中移除——这是因为Spring Boot 3.0全面转向基于Micrometer Observation API的观测方案，彻底替代了旧的HttpTrace机制。

替代方案

如果需要追踪HTTP请求的相关信息，可以通过以下方式实现：

启用Micrometer HTTP观测
Spring Boot Starter Actuator默认包含Micrometer依赖，只需在配置文件中开启HTTP观测开关：
```
management.observation.http.enabled=true
```

自定义请求追踪逻辑
若需要自定义请求数据的存储或处理逻辑，可以实现ObservationHandler接口，针对HTTP请求的观测事件做定制化处理：

import io.micrometer.observation.Observation;
import io.micrometer.observation.ObservationHandler;
import org.springframework.stereotype.Component;

@Component
public class CustomHttpObservationHandler implements ObservationHandler<Observation.Context> {
    @Override
    public boolean supportsContext(Observation.Context context) {
        // 仅处理HTTP请求相关的观测上下文
        return context.getClass().getSimpleName().contains("Http");
    }

    @Override
    public void onStart(Observation.Context context) {
        // 在这里处理请求开始时的逻辑，比如记录请求时间、路径等
    }

    @Override
    public void onStop(Observation.Context context) {
        // 在这里处理请求结束时的逻辑，比如记录响应状态、耗时等
    }
}