Spring Boot：单例服务调用会话作用域组件Setter无效，字段始终为Null

兄弟，我太懂这种盯着null值百思不得其解的滋味了！你遇到的这个坑其实是Spring不同作用域Bean依赖时的典型问题——单例服务依赖会话（session）作用域Bean时的代理机制没搞对，跟Lombok注解、Serializable接口关系不大，核心是Spring怎么处理跨作用域的依赖注入。

问题根源 #

单例服务是应用启动时就初始化好的全局实例，但会话作用域Bean是每个用户会话创建时才生成的。如果直接用@Autowired把会话Bean注入到单例服务里，Spring不会给你真实的会话实例，而是生成一个代理对象。你直接调用代理的setter方法时，很可能没正确路由到当前会话的真实Bean上，导致赋值后字段还是null。

具体解决方案 #

1. 给会话作用域Bean配置正确的代理模式

这是最常用的解决方式，给你的会话Bean加上proxyMode参数，让Spring生成能动态路由到当前会话实例的代理：

import org.springframework.web.context.WebApplicationContext;
import org.springframework.context.annotation.Scope;
import org.springframework.stereotype.Component;

@Component
@Scope(
    value = WebApplicationContext.SCOPE_SESSION,
    proxyMode = ScopedProxyMode.TARGET_CLASS // 关键配置
)
public class SessionPreferences {
    private String theme;
    private Integer pageSize;

    // 这里用Lombok的@Data或者手动写getter/setter都可以
    public String getTheme() {
        return theme;
    }

    public void setTheme(String theme) {
        this.theme = theme;
    }

    public Integer getPageSize() {
        return pageSize;
    }

    public void setPageSize(Integer pageSize) {
        this.pageSize = pageSize;
    }
}

ScopedProxyMode.TARGET_CLASS会用CGLIB生成代理类，确保单例服务拿到的代理能在每次调用时找到当前会话的真实Bean。

2. 通过ApplicationContext动态获取会话Bean（备选方案）

如果不想依赖代理，也可以在单例服务里注入Spring上下文，每次操作时手动获取当前会话的实例：

import org.springframework.context.ApplicationContext;
import org.springframework.stereotype.Service;

@Service
public class PreferenceService {
    private final ApplicationContext context;

    // 构造注入ApplicationContext
    public PreferenceService(ApplicationContext context) {
        this.context = context;
    }

    public void updateUserTheme(String newTheme) {
        // 每次调用都从上下文获取当前会话的SessionPreferences实例
        SessionPreferences preferences = context.getBean(SessionPreferences.class);
        preferences.setTheme(newTheme);
    }
}

这种方式更直接，完全绕开代理的问题，确保每次操作的都是当前用户会话的真实Bean。

3. 确保请求在会话上下文内

要注意你的REST接口必须是在有效会话中调用的：

• 如果是浏览器请求，确保请求带有JSESSIONID Cookie（Spring默认会自动创建会话）；
• 如果是前后端分离的无状态接口，可能需要通过@SessionAttributes或者自定义会话标识来绑定会话；
• 可以在控制器方法里加HttpSession参数，强制Spring创建会话：

  @PostMapping("/update-theme")
  public ResponseEntity<Void> updateTheme(@RequestParam String theme, HttpSession session) {
      preferenceService.updateUserTheme(theme);
      return ResponseEntity.ok().build();
  }
  

4. 不要长期持有会话Bean的引用

单例服务里绝对不能把会话Bean作为成员变量长期保存，比如这种写法是错误的：

@Service
public class BadPreferenceService {
    // 错误！单例服务持有会话Bean引用会导致多个会话共享同一个实例
    @Autowired
    private SessionPreferences preferences;

    public void updateTheme(String theme) {
        preferences.setTheme(theme);
    }
}

必须每次使用时通过代理或者上下文获取最新的实例，避免会话污染。

补充说明 #

关于你尝试的Lombok和Serializable：

• Lombok的@Data等注解只是简化代码，不会影响Spring的作用域处理；
• Serializable是当会话需要钝化（比如服务器内存不足时序列化到磁盘）时才需要的，跟你当前的null问题无关。

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