Spring Boot启动报错：请求作用域Bean无线程绑定请求

从错误栈能明确问题根源：Spring Boot Actuator的CacheMetricsRegistrarConfiguration在启动阶段会尝试初始化所有CacheManager Bean，但你定义的requestCacheManager是请求作用域的——启动时没有活跃的请求上下文，请求作用域未激活，因此触发ScopeNotActiveException导致启动失败。

下面是几种可行的解决办法：

方案一：排除Actuator的缓存指标自动配置 #

直接让Actuator跳过对CacheManager的指标收集，避免启动时加载请求作用域的Bean：

@SpringBootApplication(exclude = CacheMetricsRegistrarConfiguration.class)
public class YourApplication {
    public static void main(String[] args) {
        SpringApplication.run(YourApplication.class, args);
    }
}

方案二：自定义缓存指标注册逻辑，过滤请求作用域Bean #

如果需要保留其他CacheManager的指标收集，可自定义注册逻辑，跳过请求作用域的requestCacheManager：

@Configuration
public class CustomCacheMetricsConfiguration {

    @Bean
    public CacheMetricsRegistrar cacheMetricsRegistrar(MeterRegistry meterRegistry,
                                                       CacheManagerCustomizers cacheManagerCustomizers,
                                                       List<CacheManager> cacheManagers) {
        CacheMetricsRegistrar registrar = new CacheMetricsRegistrar(meterRegistry, cacheManagerCustomizers);
        // 仅注册非请求作用域的CacheManager
        cacheManagers.stream()
                .filter(this::isNotRequestScoped)
                .forEach(registrar::registerCacheManager);
        return registrar;
    }

    private boolean isNotRequestScoped(Object bean) {
        if (!AopUtils.isAopProxy(bean)) {
            return true;
        }
        TargetSource targetSource = ((Advised) bean).getTargetSource();
        if (!(targetSource instanceof ScopedTargetSource)) {
            return true;
        }
        return !WebApplicationContext.SCOPE_REQUEST.equals(((ScopedTargetSource) targetSource).getScope());
    }
}

方案三：替换请求级缓存实现方式 #

如果不需要依赖Spring Cache的CacheManager，可直接用ThreadLocal实现请求级缓存，绕开作用域问题：

@Service
public class MyService {
    private final ThreadLocal<Integer> requestCache = new ThreadLocal<>();

    public Integer getValue() {
        Integer cachedValue = requestCache.get();
        if (cachedValue != null) {
            return cachedValue;
        }
        // 这里替换成实际的业务逻辑
        Integer value = 123;
        requestCache.set(value);
        return value;
    }

    // 请求结束时清理ThreadLocal，避免内存泄漏
    @ControllerAdvice
    static class CacheCleaner {
        @Autowired
        private MyService myService;

        @AfterCompletion
        public void cleanCache() {
            myService.requestCache.remove();
        }
    }
}

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