05-樟木林项目参与

返回

樟木林项目登录策略注入与动态切换 ​

概述:就是一次简单的参与学长们开发的校园助手微信小程序,我把后端的注入方式调整了一下,报错了,之前都是 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,只是项目片段,不是完整的独立程序。

这个方案可以解释顺序调用,但不能直接当作并发请求下的推荐方案。 单例共享字段的问题放在后面说明。

SWULoginProxy.javaJava
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]

业务上的调用顺序是:

Mermaid
flowchart TD A["SWUCampusClient 发起登录"] --> B["setLoginStrategy:选择 Cookie 策略"] B --> C["login:执行 Cookie 登录"] C --> D{"登录是否成功"} D -->|是| E["返回登录结果"] D -->|否| F["setLoginStrategy:切回密码策略"] F --> G["login:执行密码登录"] G --> H["返回结果或交由调用方处理失败"]

这里的两个 setLoginStrategy() 都是普通方法调用。Spring 提供策略对象,调用方决定何时尝试、何时切换。

图中“登录失败”是业务判断,具体要按项目的登录结果、异常类型来区分。不能把所有异常都当成 Cookie 失效,否则会把真正的问题掩盖掉。

四、复盘:能切换,不代表可以随便切换 ​

单例里的可变字段,要多想一步 ​

@Component 没有另行配置作用域时,默认是单例。同一个容器里,这个 Bean 会被共享。[5]

如果多个请求同时使用这个 SWULoginProxy,就可能出现:

并发请求示意Text
请求 A:把 loginStrategy 改成 Cookie 策略
请求 B:把 loginStrategy 改成密码策略
请求 A:调用 login,实际用到的已经是密码策略
已折叠代码,点击展开

这不是注入失败,而是本次请求的策略选择被放进了共享状态。即使给字段加 volatile,也不能让“设置策略,再执行登录”这两个步骤自动成为一个整体。

这个风险是对原方案的补充分析,不代表项目里已经发生过这样的故障。

2026-10-08 补充:如果用于并发请求,更合适的方向是固定依赖,把策略选择留在本次调用中。

例如,保留密码策略作为默认依赖,通过参数传入本次要执行的策略,不再改共享字段:

SWULoginProxy.javaJava
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 候选选择,分别是不同层面的问题。
  • 策略模式负责把不同登录方式拆开,不自动解决策略选择、失败处理和并发安全。

最重要的是:先想清楚谁创建对象、谁选择策略、这个状态属于谁,再决定怎么写注入。