樟木林项目登录策略注入与动态切换
概述:就是一次简单的参与学长们开发的校园助手微信小程序,我把后端的注入方式调整了一下,报错了,之前都是 Autowire ,改成了官方更加推荐的 private final 形式,但是 private final 都已经 final 了,那么实例对象就无法切换,但是有些实例对象是动态调整的。
出 BUG 的点就在那个登录策略的类上,登录策略不止一种,自动尝试然后降级处理,如果改成 final ,会出问题,只有一种登录方式失效。
这也算是比较常见的场景了,同一个类多个实现,然后依赖注入的时候需要动态切换,不能直接静态注入。
最终是通过 setter 注入的,没加 final。
一、问题出在什么地方
在樟木林项目中,SWULoginProxy 负责把登录操作交给具体的策略,策略统一实现 SWULoginStrategy 接口。
默认采用密码登录,但处理请求时,可能先尝试 Cookie 登录,失败后再切回密码登录。也就是说,默认策略要能通过 Spring 注入,实际使用的策略又要能在运行时切换。
当时我把两件事混在一起了:
- 以为“构造器注入失败后,可以改用 setter 注入”来实现登录兜底。
- 把业务代码里的
setLoginStrategy()调用,也当成了 Spring 的 setter 注入。 - 想沿用
final和 Lombok 的@RequiredArgsConstructor,却没有区分字段能不能被重新赋值、构造器会不会生成,以及 Spring 到底要注入哪个实现。
问题不在于哪一种注入方式更灵活,而是对象的创建过程,和登录失败后的业务处理,是两个不同的阶段。
二、先分清注入和切换
Spring 负责创建对象时的依赖
构造器注入解决的是:创建 SWULoginProxy 时,默认的登录策略从哪里来。
后续业务代码调用 setLoginStrategy(cookieLogin),只是把已经拿到的策略对象赋给字段。方法叫 setter,不代表这次调用就是 Spring 的 setter 注入。要看是谁调用它、为什么调用它。
因此,Cookie 登录失败后切回密码登录,是业务上的 fallback,不是构造器注入失败后的补救。依赖解析不清楚,就应该解决 Bean 的选择问题,而不是等登录时再处理。
这里也需要修正原先“注入只在启动时发生一次”的说法。更准确地说,依赖注入发生在 Bean 创建、装配的过程中。默认的非懒加载单例通常在容器启动时创建,但懒加载、其他作用域的 Bean,创建时机可以不同。[1]
final 限制的是引用重新赋值
如果设计是通过 setter 替换 loginStrategy 指向的策略对象,那这个字段就不能是 final。
但不能反过来说“用了策略模式,字段就不能是 final”。如果把不同策略都注入进来,每次调用时再选择执行哪个策略,依赖字段仍然可以是 final。需要变化的是本次调用的选择,不一定是对象里保存的依赖。
Lombok 不负责决定注入哪个策略
@RequiredArgsConstructor 会为未初始化的 final 字段,以及未初始化、标了 @NonNull 的字段生成构造器参数。普通的可变字段,没有 @NonNull,就不会因为这个注解自动进入构造器。[2]
所以,当时保留可变策略字段的写法,需要显式编写构造器来接收默认策略。不是“去掉 final 就一定要手写构造器”,而是要看这个字段是否还在 Lombok 的生成范围内。
Lombok 解决的是生成代码,Spring 解决的是依赖装配。两者不是同一件事,也不会自动替我决定默认使用密码登录还是 Cookie 登录。
接口有多个实现,就把选择说清楚
如果容器里有多个 SWULoginStrategy 实现,又没有明确的候选选择规则,直接按接口注入就可能产生歧义。不是接口不能注入,而是 Spring 不知道这里应该选哪个。
当时的写法是让构造器参数直接使用 SWUPasswordLoginStrategy,明确默认采用密码登录。前提是这个具体类型能匹配到唯一的 Bean。
也可以继续依赖接口,通过 @Qualifier 指定候选,或者用 @Primary 设置默认候选。[3] 两种写法各有取舍:具体类直观,但绑定了实现;接口配合限定符,保留了接口依赖。没有必要把其中一种说成绝对更好。
三、当时的写法与调用过程
下面保留当时的核心写法,用来说明默认注入和运行时切换的区别。代码依赖项目已有的策略接口、实现类与 OkHttp,只是项目片段,不是完整的独立程序。
这个方案可以解释顺序调用,但不能直接当作并发请求下的推荐方案。 单例共享字段的问题放在后面说明。
import okhttp3.OkHttpClient;
import org.springframework.stereotype.Component;
@Component
public class SWULoginProxy {
private SWULoginStrategy loginStrategy;
// 默认策略在创建 Bean 时注入
public SWULoginProxy(SWUPasswordLoginStrategy defaultStrategy) {
this.loginStrategy = defaultStrategy;
}
// 由业务代码调用,不是 Spring 再次注入
public void setLoginStrategy(SWULoginStrategy strategy) {
this.loginStrategy = strategy;
}
public OkHttpClient login(String studentId, String password) {
return loginStrategy.execute(studentId, password);
}
}类中只有这一个构造器时,不需要额外标 @Autowired,Spring 可以使用它完成构造器注入。[4]
业务上的调用顺序是:
这里的两个 setLoginStrategy() 都是普通方法调用。Spring 提供策略对象,调用方决定何时尝试、何时切换。
图中“登录失败”是业务判断,具体要按项目的登录结果、异常类型来区分。不能把所有异常都当成 Cookie 失效,否则会把真正的问题掩盖掉。
四、复盘:能切换,不代表可以随便切换
单例里的可变字段,要多想一步
@Component 没有另行配置作用域时,默认是单例。同一个容器里,这个 Bean 会被共享。[5]
如果多个请求同时使用这个 SWULoginProxy,就可能出现:
请求 A:把 loginStrategy 改成 Cookie 策略
请求 B:把 loginStrategy 改成密码策略
请求 A:调用 login,实际用到的已经是密码策略这不是注入失败,而是本次请求的策略选择被放进了共享状态。即使给字段加 volatile,也不能让“设置策略,再执行登录”这两个步骤自动成为一个整体。
这个风险是对原方案的补充分析,不代表项目里已经发生过这样的故障。
2026-10-08 补充:如果用于并发请求,更合适的方向是固定依赖,把策略选择留在本次调用中。
例如,保留密码策略作为默认依赖,通过参数传入本次要执行的策略,不再改共享字段:
import okhttp3.OkHttpClient;
import org.springframework.stereotype.Component;
@Component
public class SWULoginProxy {
private final SWULoginStrategy defaultStrategy;
public SWULoginProxy(SWUPasswordLoginStrategy defaultStrategy) {
this.defaultStrategy = defaultStrategy;
}
public OkHttpClient login(String studentId, String password) {
return loginWithStrategy(defaultStrategy, studentId, password);
}
public OkHttpClient loginWithStrategy(
SWULoginStrategy strategy, String studentId, String password) {
return strategy.execute(studentId, password);
}
}调用方先用 Cookie 策略调用 loginWithStrategy(),需要兜底时再调用默认的 login()。这个改法只解决代理里共享“当前策略”的问题,策略对象本身如果保存了用户信息、Cookie 等可变状态,仍然要单独检查。
这是后续调整的示意,不是已经验证、替换进项目的代码。
这次真正需要记住的
- 构造器注入解决对象创建时的依赖,登录 fallback 解决运行时的业务选择。
- setter 是一种方法形式,是否属于依赖注入,要看调用过程,不能只看方法名。
final、Lombok 构造器和 Spring 候选选择,分别是不同层面的问题。- 策略模式负责把不同登录方式拆开,不自动解决策略选择、失败处理和并发安全。
最重要的是:先想清楚谁创建对象、谁选择策略、这个状态属于谁,再决定怎么写注入。