当前位置: 代码网 > it编程>编程语言>Java > Spring构造器注入及@Autowired、lombok的@RequiredArgsConstructor的异同点说明

Spring构造器注入及@Autowired、lombok的@RequiredArgsConstructor的异同点说明

2026年03月01日 Java 我要评论
一、构造器注入:spring 是如何 “找到参数” 的?构造器sysusercontroller:public sysusercontroller(sysuserservice

一、构造器注入:spring 是如何 “找到参数” 的?

构造器sysusercontroller:

public sysusercontroller(sysuserservice sysuserservice, 
                         applicationcontext applicationcontext, 
                         userauthservice userauthservice) {
    this.sysuserservice = sysuserservice;
    this.applicationcontext = applicationcontext;
    this.userauthservice = userauthservice;
}

spring 创建 sysusercontroller bean 时,找构造器参数的过程分 3 步,核心是「按类型匹配 + 按名称兜底」:

步骤 1:扫描并注册所有 bean

spring 启动时,会扫描标注了 @service/@component/@repository 等注解的类,把它们实例化成 bean,并存入「spring 容器」(可以理解为一个 “bean 字典”):

  • sysuserservice:因为加了 @service,会被注册为「类型 = sysuserservice,名称 = sysuserservice」的 bean;
  • applicationcontext:spring 内置的核心 bean,启动时自动注册,类型就是 applicationcontext
  • userauthservice:它的实现类(比如 userauthserviceimpl)加了 @service,会被注册为「类型 = userauthservice(接口),名称 = userauthserviceimpl」的 bean。

步骤 2:解析构造器参数,按「类型」匹配 bean

spring 发现 sysusercontroller 有且只有一个有参构造器,会:

遍历构造器的每个参数,先按「参数类型」去容器里找匹配的 bean:

  • 第一个参数 sysuserservice:容器里有且只有一个 sysuserservice 类型的 bean → 直接匹配;
  • 第二个参数 applicationcontext:容器里只有一个 spring 内置的 applicationcontext bean → 直接匹配;
  • 第三个参数 userauthservice:容器里有 userauthservice 类型的实现类 bean → 直接匹配。

如果一个类型对应多个 bean(比如有两个 userauthservice 实现类),spring 会再按「参数名称」匹配(比如参数名是 userauthservice,就找名称为 userauthservice 的 bean);

把匹配到的 bean 作为参数,调用构造器,创建 sysusercontroller 实例。

步骤 3:特殊情况处理(兜底逻辑)

  • 如果按类型 / 名称都找不到参数对应的 bean → 抛出 nosuchbeandefinitionexception(bean 不存在);
  • 如果一个类型有多个 bean,且参数名称也匹配不上 → 抛出 nouniquebeandefinitionexception(bean 不唯一);

解决方法:用 @qualifier("bean名称") 标注参数,指定具体要哪个 bean,比如:

运行

public sysusercontroller(sysuserservice sysuserservice, 
                         applicationcontext applicationcontext, 
                         @qualifier("userauthserviceimpl") userauthservice userauthservice) {
    // ...
}

二、构造器注入 vs @autowired:核心本质差异

先给结论:两者最终都是从 spring 容器找 bean,但注入时机、强制约束、安全性完全不同,用表格对比核心差异:

表格

维度构造器注入@autowired 字段注入
注入时机bean 实例化时(构造阶段)bean 实例化后(初始化阶段)
依赖强制性必须找到所有参数 bean,否则实例化失败可选(默认 required=true,可设 false)
字段不可变性可加 final,实例化后字段不可修改不能加 final,字段可被篡改
空指针风险无(实例化时就注入,字段必不为 null)有(初始化失败时字段为 null)
依赖透明度所有依赖都在构造器参数里,一目了然依赖藏在字段里,需看注解才知道
循环依赖处理无法解决循环依赖(spring 不支持)可以解决循环依赖(spring 缓存半成品)
单元测试友好性直接传参创建实例,无需 spring 容器需 mock 容器或反射注入,繁琐

关键差异拆解(通俗版)

1. 注入时机:“先有鸡还是先有蛋”

  • 构造器注入:创建 sysusercontroller 实例时,必须先拿到所有参数 bean → 实例化完成后,所有依赖都已就绪;
  • @autowired 字段注入:先调用无参构造器创建 sysusercontroller 空实例 → 再通过反射给字段赋值 → 如果赋值失败,实例已经创建但字段是 null。

举个例子:如果 sysuserservice bean 不存在:

  • 构造器注入:spring 连 sysusercontroller 实例都创建不出来,启动直接报错,提前暴露问题;
  • @autowired 注入:sysusercontroller 实例能创建,但 sysuserservice 字段是 null → 运行时调用 sysuserservice 才会报空指针,问题暴露晚。

2. 不可变性:“常量 vs 变量”

  • 构造器注入的字段可以加 final,一旦赋值就不能改 → 线程安全(多线程调用 controller 时,字段不会被篡改);
  • @autowired 字段不能加 final(加了会编译报错)→ 字段可能被反射 / 代码篡改,有线程安全风险。

3. 循环依赖:“死循环 vs 缓兵之计”

  • 构造器注入:如果 a 的构造器依赖 b,b 的构造器又依赖 a → spring 实例化时会陷入死循环,直接报错(强制你解耦,是好事);
  • @autowired 字段注入:spring 会创建 “半成品 bean”(实例化但未初始化),暂时缓存 → 先给 a 注入 b 的半成品,再给 b 注入 a 的半成品 → 表面解决循环依赖,但会埋下运行时隐患。

三、为什么 spring 官方推荐构造器注入?

结合你的代码场景,推荐构造器注入的核心原因:

  1. 提前暴露问题:如果 sysuserservice/userauthservice 没被注册为 bean,启动时就报错,而不是运行时才发现;
  2. 依赖透明:看构造器就知道 sysusercontroller 依赖哪些 bean,不用翻字段注解;
  3. 线程安全final 字段不可变,controller 是单例 bean,多线程调用时不会出问题;
  4. 测试方便:单元测试时,不用启动 spring 容器,直接 new sysusercontroller(mocksysuserservice, mockcontext, mockuserauthservice) 就能创建实例,无需 mock 注解。

总结:

构造器注入找参数的逻辑:spring 先扫描注册所有 bean → 按参数「类型」匹配 bean → 类型不唯一时按「名称」匹配 → 匹配失败则启动报错;

和 @autowired 的本质差异:核心是「注入时机」和「依赖强制性」—— 构造器注入是 “实例化时必须有依赖”,@autowired 是 “实例化后可选注入”;

实战建议

  • 必需依赖(比如你的 sysuserservice/userauthservice)→ 用构造器注入 + final
  • 可选依赖(非必须的 bean)→ 用 @autowired(required = false)
  • 杜绝 “构造器 + @autowired” 混用,避免依赖不透明和初始化风险。

你的这段构造器注入代码是完全符合 spring 最佳实践的,这也是为什么我们之前要把 sysuserservice 加到构造器里,而不是保留 @autowired 的原因。

spring 注入规范的核心细节,我会结合你的代码场景,用 “原理 + 实战” 的方式讲清楚,让你不仅知其然,还知其所以然。

四、final在构造器注入中「不是必须加,但强烈推荐加」

1.final的核心作用(不是为了 spring,是为了你的代码)

final 修饰字段的含义是:字段一旦赋值,就不能被修改。在构造器注入中加 final 的核心价值和 spring 注入逻辑无关,而是为了代码的「安全性 + 可读性」:

  • 线程安全:controller 是 spring 单例 bean(整个应用只有一个实例),多线程调用时,final 字段不会被篡改(比如不会被反射 / 其他代码意外赋值为 null);
  • 依赖不可变:明确表示这些依赖是 controller 运行的 “必需品”,实例化后绝不更改;
  • 编译期校验:如果构造器没有给 final 字段赋值,编译器会直接报错(比如漏写 this.sysuserservice = sysuserservice),提前规避低级错误。

2. 不加final会怎么样?

如果去掉 final

private sysuserservice sysuserservice; // 去掉final
private applicationcontext applicationcontext;
private userauthservice userauthservice;

public sysusercontroller(sysuserservice sysuserservice, applicationcontext applicationcontext, userauthservice userauthservice) {
    this.sysuserservice = sysuserservice;
    this.applicationcontext = applicationcontext;
    this.userauthservice = userauthservice;
}
  • spring 依然能正常注入(构造器注入的核心是 “构造器传参”,和 final 无关);
  • 但字段变成 “可变的”,存在被篡改的风险(比如在某个方法里写 this.sysuserservice = null);
  • 代码可读性下降:无法一眼看出这些依赖是 “必需且不可变” 的。

3. 总结:final的使用原则

表格

场景是否加 final原因
构造器注入的「必需依赖」必须加线程安全 + 依赖不可变 + 编译校验
构造器注入的「可选依赖」不加(实际很少见,可选依赖建议用 @autowired (required=false))

你的代码中 sysuserservice/applicationcontext/userauthservice 都是 controller 的必需依赖,加 final 是完全符合最佳实践的。

五、为什么你的代码不用@requiredargsconstructor?

1. 先搞懂@requiredargsconstructor是什么

@requiredargsconstructor 是 lombok 提供的注解,作用是:自动为类中所有 final 字段生成对应的构造器

@requiredargsconstructor // 加这个注解
@restcontroller
@requestmapping("/user")
public class sysusercontroller {
    private final sysuserservice sysuserservice;
    private final applicationcontext applicationcontext;
    private final userauthservice userauthservice;

    // 不用手动写构造器,lombok 会自动生成下面的代码:
    // public sysusercontroller(sysuserservice sysuserservice, applicationcontext applicationcontext, userauthservice userauthservice) {
    //     this.sysuserservice = sysuserservice;
    //     this.applicationcontext = applicationcontext;
    //     this.userauthservice = userauthservice;
    // }
}

2. 你的代码不用@requiredargsconstructor的核心原因

不是 “不能用”,而是 “手动写构造器更清晰”,具体分两种情况:

  • 情况 1:你想「显式控制构造器」手动写构造器可以清晰看到所有依赖,尤其是团队协作时,新人不用去查 lombok 注解的作用,直接看构造器就知道依赖了哪些 bean;
  • 情况 2:不需要 lombok 简化(字段少)你的构造器只有 3 个参数,手动写的代码量很少,没必要用 lombok 注解;如果构造器参数有 5+ 个,用 @requiredargsconstructor 能减少重复代码。

3. 手动构造器 vs@requiredargsconstructor的对比

维度手动写构造器@requiredargsconstructor
代码可读性高(直接看构造器)中(需知道注解作用)
代码量稍多(3 行赋值)极少(1 行注解)
编译期依赖无(纯 java 语法)需 lombok 插件 / 依赖
调试友好性高(断点可直接打到构造器)中(需 lombok 反编译看生成的代码)

4. 补充:如果要用@requiredargsconstructor,代码怎么写?

你的代码可以改成这样(完全等价,且更简洁):

@slf4j
@requiredargsconstructor // 替代手动构造器
@restcontroller
@requestmapping("/user")
public class sysusercontroller {
    private final sysuserservice sysuserservice;
    private final applicationcontext applicationcontext;
    private final userauthservice userauthservice;

    // 无需手动写构造器,lombok 自动生成
    // ... login 方法等逻辑不变
}

总结

关于 final

  • 构造器注入中 final 不是 spring 强制要求的,但「必需依赖」强烈推荐加;
  • 核心价值:线程安全、依赖不可变、编译期校验,和构造器注入的 “找参数逻辑” 无关。

关于 @requiredargsconstructor

  • 你的代码不用这个注解,是因为「手动写构造器更清晰」,而非技术上不可用;
  • 如果想简化代码,加 @requiredargsconstructor 完全可行,和手动构造器效果一致。

你的这段代码写法(final 字段 + 手动构造器注入)是 spring 官方最推荐的 “标准写法”,既保证了代码的安全性,又兼顾了可读性,完全无需调整。

以上为个人经验,希望能给大家一个参考,也希望大家多多支持代码网。

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2026  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com