Spring中@Scope注解不支持直接自定义作用域，但可通过实现Scope接口、注册自定义作用域（如ThreadScope）、再用@Scope("thread")引用三步实现；需注意线程安全、代理配置及上下文清理。
Spring 中的 @Scope 注解本身不支持直接“自定义作用域”，它只用于声明 Bean 属于 Spring 内置的几种作用域（如 singleton、prototype、request、session 等）。但你可以通过实现 org.springframework.beans.factory.config.Scope 接口，注册一个**自定义作用域（Custom Scope）**，再配合 @Scope 引用该作用域名称，从而达到“自定义域”的效果。
1. 实现自定义 Scope 接口
你需要提供一个类，实现 Scope 接口的四个核心方法：
-
get(String name, ObjectFactory> objectFactory)：获取或创建 Bean 实例（关键逻辑所在） -
remove(String name)：移除指定 Bean 实例 -
registerDestructionCallback(String name, Runnable callback)：注册销毁回调（可选，如需清理资源） -
resolveContextualObject(String key)：解析上下文相关对象（如request中的参数，按需实现） -
getConversationId()：返回当前作用域唯一标识（如 session ID、线程 ID 等，用于区分不同上下文）
例如，实现一个基于当前线程（ThreadLocal）的 thread 作用域：
public class ThreadScope implements Scope {
private final ThreadLocal<Map<String, Object>> threadMap = ThreadLocal.withInitial(HashMap::new);
private final ThreadLocal<Map<String, Runnable>> destructionCallbacks = ThreadLocal.withInitial(HashMap::new);
@Override
public Object get(String name, ObjectFactory<?> objectFactory) {
Map<String, Object> scope = threadMap.get();
Object obj = scope.get(name);
if (obj == null) {
obj = objectFactory.getObject();
scope.put(name, obj);
}
return obj;
}
@Override
public Object remove(String name) {
Map<String, Object> scope = threadMap.get();
Object obj = scope.remove(name);
// 触发销毁回调（如果注册过）
Runnable callback = destructionCallbacks.get().remove(name);
if (callback != null) callback.run();
return obj;
}
@Override
public void registerDestructionCallback(String name, Runnable callback) {
destructionCallbacks.get().put(name, callback);
}
@Override
public Object resolveContextualObject(String key) {
return null; // 本例无需上下文对象
}
@Override
public String getConversationId() {
return String.valueOf(Thread.currentThread().getId());
}
}
2. 向容器注册自定义 Scope
在配置类中（或 XML 配置中），将自定义 Scope 注册到 ConfigurableBeanFactory：
立即学习“Java免费学习笔记（深入）”；
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
@Configuration
public class ScopeConfig {
@Bean
@Primary // 可选，避免与默认 scope 冲突
public static CustomScopeConfigurer customScopeConfigurer() {
CustomScopeConfigurer configurer = new CustomScopeConfigurer();
configurer.addScope("thread", new ThreadScope()); // “thread” 是你后续 @Scope("thread") 引用的名称
return configurer;
}
}
⚠️ 注意：CustomScopeConfigurer 必须是 @Bean 方法且为 static，否则可能因依赖顺序导致注册失败。
3. 在 Bean 上使用 @Scope("your-scope-name")
注册成功后，即可在任意 @Component、@Service 或 @Bean 方法上使用你的自定义作用域名：
@Service
@Scope("thread") // ✅ 对应上面注册的 "thread"
public class UserService {
private final long createTime = System.currentTimeMillis();
public long getCreateTime() { return createTime; }
}
每次新线程调用时，会拿到独立的 UserService 实例；同一线程内多次 getBean(UserService.class) 返回同一个实例。
4. 注意事项和常见问题
-
线程安全与内存泄漏：自定义 Scope（尤其 ThreadLocal）需确保及时清理。建议配合
@PreDestroy或 AOP 在线程退出前调用remove，避免线程复用（如 Tomcat 线程池）导致内存堆积 -
代理模式：若 Bean 有接口，Spring 默认用 JDK 动态代理；若无接口，用 CGLIB。当作用域非 singleton 时，通常需配合
@Scope(proxyMode = ScopedProxyMode.TARGET_CLASS)，确保注入的是代理对象，能正确路由到当前上下文实例 - 作用域继承：自定义 Scope 不自动参与作用域层级（如 request → session），需自行设计上下文传播逻辑（如手动绑定/解绑 ThreadLocal）
-
测试友好性：单元测试中需主动模拟作用域上下文（如设置 ThreadLocal），或使用
@DirtiesContext隔离测试
不复杂但容易忽略。核心就三步：写 Scope 实现类、注册进工厂、用注解引用名字。真正难点在于理解生命周期边界和上下文隔离逻辑。
