Spring Boot 3X 框架核心组件的使用详解_Java

spring boot 框架核心组件的完整使用详解，我会聚焦 spring boot 最常用、企业开发必备的核心组件，从组件核心作用、配置方式、实战代码、使用场景四个维度讲解，基于spring boot 3.2.x（最新稳定版，适配 java 17+、spring 6），所有代码都是可直接复制的开箱即用版本，同时兼顾注解式配置（主流）和核心原理极简解读，让你既能快速上手使用，也能理解组件间的配合逻辑。

前置基础

spring boot 的核心是约定大于配置，通过自动配置（autoconfiguration） 消除 spring 原生的繁琐 xml 配置，所有组件都基于starter 起步依赖引入，只需少量配置（甚至零配置）即可使用。

核心依赖：spring-boot-starter（基础核心），所有组件都基于此扩展；
开发工具：spring-boot-starter-devtools（热部署）、spring-boot-configuration-processor（配置提示）；
构建方式：maven/gradle（本文以 maven 为例，适配 idea 默认工程）。

一、核心基础组件（所有项目必用）

1. starter 起步依赖（组件入口）

核心作用

starter 是 spring boot 的组件依赖封装，将某个功能的所有相关依赖（如核心包、依赖包、配置包）整合为一个 maven/gradle 依赖，只需引入 1 个 starter，即可自动引入该功能的所有必要依赖，避免手动管理依赖版本、解决依赖冲突。

核心设计

命名规范：官方 starter 为spring-boot-starter-*（如spring-boot-starter-web），第三方 starter 为*spring-boot-starter（如mybatis-spring-boot-starter）；
自动配置：starter 内置meta-inf/spring/org.springframework.boot.autoconfigure.autoconfiguration.imports文件，指定该组件的自动配置类，spring boot 启动时会自动加载。

实战使用（pom.xml）

<!-- 基础核心starter（所有spring boot项目必加） -->
<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter</artifactid>
</dependency>
<!-- web开发starter（mvc+tomcat，后端接口必加） -->
<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-web</artifactid>
</dependency>
<!-- 测试starter（junit5+mockmvc，单元测试必加） -->
<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-test</artifactid>
    <scope>test</scope>
</dependency>

2. 主启动类（@springbootapplication）

核心作用

spring boot 项目的入口类，通过注解开启自动配置、组件扫描、配置属性绑定三大核心功能，是项目启动的唯一入口。

核心注解拆解（@springbootapplication 是复合注解）

// 核心复合注解，等价于以下三个注解的组合
@springbootapplication = @springbootconfiguration + @enableautoconfiguration + @componentscan

@springbootconfiguration：继承自@configuration，标记该类为配置类，可在类中用@bean声明自定义组件；
@enableautoconfiguration：开启自动配置，加载所有 starter 的自动配置类，实现 “零配置” 使用组件；
@componentscan：开启组件扫描，自动扫描当前包及其子包下的@controller/@service/@repository/@component注解类，将其注册为 spring bean。

实战使用（主启动类代码）

import org.springframework.boot.springapplication;
import org.springframework.boot.autoconfigure.springbootapplication;
// 注解加在主类上，扫描包：com.example.demo及其所有子包
@springbootapplication
// 可选：指定扫描包（若主类不在项目根包，需手动指定）
// @springbootapplication(scanbasepackages = "com.example")
public class springbootcomponentdemoapplication {
    // 项目启动入口方法，固定写法
    public static void main(string[] args) {
        // 启动spring boot应用，返回spring容器（applicationcontext）
        springapplication.run(springbootcomponentdemoapplication.class, args);
    }
}

关键注意

主启动类建议放在项目根包（如com.example.demo），否则需用scanbasepackages手动指定扫描包，否则子包的组件无法被 spring 扫描并注册。

3. 配置文件（application.yml/properties）

核心作用

spring boot 的全局配置文件，用于覆盖组件的默认自动配置（如端口、数据库连接、日志级别），支持yml（推荐，层级清晰） 和properties（键值对） 两种格式，项目启动时会自动加载src/main/resources/下的该文件。

配置优先级

application-dev.yml（开发环境） > application-prod.yml（生产环境） > application.yml（全局默认），可通过多环境配置切换不同环境的配置。

核心使用

（1）基础配置（application.yml，修改默认端口 / 上下文路径）

# 服务器配置（覆盖spring-boot-starter-web的默认配置）
server:
  port: 8081 # 项目启动端口，默认8080
  servlet:
    context-path: /demo # 接口上下文路径，默认/，访问时需加/demo（如http://localhost:8081/demo/hello）
# spring核心配置
spring:
  application:
    name: spring-boot-component-demo # 项目名称，服务注册/日志中会使用

（2）多环境配置（最常用，避免开发 / 生产配置混用）

新建多环境配置文件：
- 开发环境：application-dev.yml（本地开发，端口 8081，日志级别 debug）
- 生产环境：application-prod.yml（线上部署，端口 80，日志级别 info）
在application.yml中指定激活的环境：

spring:
  profiles:
    active: dev # 激活开发环境，改为prod即切换到生产环境

（3）自定义配置与属性绑定（@value/@configurationproperties）

开发中常需要自定义配置（如自定义接口前缀、业务常量），spring boot 提供两种方式绑定到 java 类：

方式 1：@value（简单配置，单个属性绑定）适合单个 / 少量自定义属性，直接在 bean 中注入：

import org.springframework.beans.factory.annotation.value;
import org.springframework.web.bind.annotation.getmapping;
import org.springframework.web.bind.annotation.restcontroller;
@restcontroller
public class hellocontroller {
    // 绑定yml中的自定义配置：app.api-prefix
    @value("${app.api-prefix:/api/v1}") // 冒号后为默认值，若配置中无该属性则使用默认值
    private string apiprefix;
    @getmapping("/hello")
    public string hello() {
        return "hello spring boot! 接口前缀：" + apiprefix;
    }
}

对应的 yml 配置：

# 自定义配置
app:
  api-prefix: /api/v2

方式 2：@configurationproperties（复杂配置，批量绑定）适合多个相关自定义属性（如微信配置、oss 配置），批量绑定到一个配置类，更规范、支持配置提示：步骤 1：编写配置类，添加注解：

import org.springframework.boot.context.properties.configurationproperties;
import org.springframework.stereotype.component;
// 组件注解：将该类注册为spring bean
@component
// 配置前缀：绑定yml中的wechat节点下的所有属性
@configurationproperties(prefix = "wechat")
public class wechatproperties {
    // 与yml中的属性名一致（驼峰自动匹配横杠命名：app-id → appid）
    private string appid;
    private string appsecret;
    private string mchid; // 商户号
    // 必须提供getter/setter，否则无法绑定（lombok的@data可自动生成）
    public string getappid() { return appid; }
    public void setappid(string appid) { this.appid = appid; }
    public string getappsecret() { return appsecret; }
    public void setappsecret(string appsecret) { this.appsecret = appsecret; }
    public string getmchid() { return mchid; }
    public void setmchid(string mchid) { this.mchid = mchid; }
}

步骤 2：yml 中添加对应配置：

# 微信配置
wechat:
  app-id: wx1234567890abcdef
  app-secret: 1234567890abcdef1234567890abcdef
  mch-id: 1234567890

步骤 3：在业务类中注入使用：

import org.springframework.beans.factory.annotation.autowired;
import org.springframework.web.bind.annotation.getmapping;
import org.springframework.web.bind.annotation.restcontroller;
@restcontroller
public class wechatcontroller {
    // 注入配置类
    @autowired
    private wechatproperties wechatproperties;
    @getmapping("/wechat/info")
    public string wechatinfo() {
        return "微信appid：" + wechatproperties.getappid() + "，商户号：" + wechatproperties.getmchid();
    }
}

步骤 4：添加配置提示依赖（可选，idea 中显示配置注解，避免手敲错误）：

<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-configuration-processor</artifactid>
    <optional>true</optional>
</dependency>

4. 核心注解（bean 注册与依赖注入）

spring boot 的所有组件都基于spring ioc 容器，核心是将对象交给 spring 管理（bean 注册） + 从 spring 容器中获取对象（依赖注入），以下是最核心的注解，所有业务开发都离不开：

（1）bean 注册注解（将类交给 spring 管理）

标记在类上，spring 启动时会自动扫描并创建该类的实例，存入 ioc 容器，全局唯一（默认单例）。

注解	作用	适用场景
`@component`	通用 bean 注册注解	通用工具类、非业务层类
`@controller`	继承自 @component，标记控制层	接口请求处理类（接收请求、返回响应）
`@service`	继承自 @component，标记服务层	业务逻辑处理类（核心业务、事务控制）
`@repository`	继承自 @component，标记数据访问层	数据库操作类（dao/mapper，mybatis 中一般用 @mapper 替代）
`@configuration`	标记配置类	声明自定义 bean（如第三方组件配置、拦截器配置）

（2）依赖注入注解（从 spring 容器中获取 bean）

标记在字段 / 构造方法 /setter 方法上，spring 会自动从 ioc 容器中找到对应的 bean，注入到当前类中，无需手动new对象，实现解耦。

注解	作用	特点
`@autowired`	按类型注入 bean	spring 核心注解，自动匹配类型，支持`required = false`（非必须注入）
`@resource`	按名称注入 bean（jdk 原生）	若有多个同类型 bean，可通过`name`指定，如`@resource(name = "userserviceimpl")`
`@qualifier`	配合 @autowired，按名称注入	解决同类型多个 bean 的注入问题，如`@autowired + @qualifier("userserviceimpl")`

（3）自定义 bean 声明（@bean）

标记在配置类的方法上，用于将第三方组件 / 无注解的类注册为 spring bean（如 redistemplate、resttemplate），方法返回值即为 bean 实例，方法名为 bean 名称。

import org.springframework.context.annotation.bean;
import org.springframework.context.annotation.configuration;
import org.springframework.web.client.resttemplate;
// 配置类
@configuration
public class webconfig {
    // 声明resttemplate为spring bean，全局可注入使用
    @bean
    public resttemplate resttemplate() {
        return new resttemplate();
    }
}

使用时直接注入：

@autowired
private resttemplate resttemplate; // 无需new，直接使用

二、web 开发核心组件（后端接口必用）

基于spring-boot-starter-web，实现 restful 接口开发，包含mvc 核心、请求处理、响应处理、拦截器、跨域等，是后端开发最核心的组件。

1. @restcontroller & @controller（请求处理核心）

核心区别

@restcontroller = @controller + @responsebody：返回 json 数据（restful 接口首选），所有方法的返回值都会自动序列化为 json，无需手动加 @responsebody；
@controller：返回视图（传统 ssm 开发，如 jsp/thymeleaf），适合前后端不分离项目，若需返回 json，需在方法上加@responsebody。

实战使用（restful 接口）

import org.springframework.web.bind.annotation.*;
// 标记为restcontroller，所有方法返回json
@restcontroller
// 类级别的请求路径，所有方法的路径都基于此（如/hello → /user/hello）
@requestmapping("/user")
public class usercontroller {
    // get请求：查询用户，路径/ user /get/{id}（路径参数）
    @getmapping("/get/{id}")
    // @pathvariable：获取url路径中的参数
    public string getuser(@pathvariable long id) {
        return "{\"id\":" + id + ", \"name\":\"张三\", \"age\":25}";
    }
    // post请求：新增用户，接收json参数
    @postmapping("/add")
    // @requestbody：将请求体的json字符串绑定到user对象（自动反序列化）
    public string adduser(@requestbody user user) {
        return "新增用户成功：" + user.getname();
    }
    // get请求：分页查询，接收请求参数（如/page?pagenum=1&pagesize=10）
    @getmapping("/page")
    // @requestparam：获取请求参数，支持默认值
    public string pagequery(@requestparam integer pagenum, @requestparam(defaultvalue = "10") integer pagesize) {
        return "分页查询：第" + pagenum + "页，每页" + pagesize + "条";
    }
}
// 实体类（配合@requestbody使用，需提供getter/setter，lombok@data可简化）
class user {
    private long id;
    private string name;
    private integer age;
    public long getid() { return id; }
    public void setid(long id) { this.id = id; }
    public string getname() { return name; }
    public void setid(string name) { this.name = name; }
    public integer getage() { return age; }
    public void setage(integer age) { this.age = age; }
}

核心请求注解（@getmapping/@postmapping 等）

都是@requestmapping的简化版，指定请求方式，避免在 @requestmapping 中手动设置method = requestmethod.get：

@getmapping：处理 get 请求（查询）
@postmapping：处理 post 请求（新增）
@putmapping：处理 put 请求（修改）
@deletemapping：处理 delete 请求（删除）
@patchmapping：处理 patch 请求（局部修改）

2. 全局异常处理（@restcontrolleradvice + @exceptionhandler）

核心作用

统一处理项目中所有的未捕获异常，避免接口返回默认的 500 错误页面 / 杂乱的异常信息，返回统一的 json 格式响应，提升接口的友好性和可维护性。

核心注解

@restcontrolleradvice：全局异常处理类注解，继承自@controlleradvice，配合@exceptionhandler使用，返回 json 数据；
@exceptionhandler：标记异常处理方法，指定处理的异常类型（如exception.class处理所有异常，nullpointerexception.class处理空指针异常）。

实战使用（统一异常返回）

import org.springframework.http.httpstatus;
import org.springframework.web.bind.annotation.exceptionhandler;
import org.springframework.web.bind.annotation.restcontrolleradvice;
import java.util.hashmap;
import java.util.map;
// 全局异常处理，作用于所有@restcontroller
@restcontrolleradvice
public class globalexceptionhandler {
    // 处理所有未捕获的异常（兜底）
    @exceptionhandler(exception.class)
    public map<string, object> handleallexception(exception e) {
        map<string, object> result = new hashmap<>();
        result.put("code", httpstatus.internal_server_error.value()); // 500
        result.put("msg", "服务器内部错误：" + e.getmessage()); // 异常信息
        result.put("data", null);
        return result;
    }
    // 处理自定义业务异常（推荐，项目中自定义异常，精准处理）
    @exceptionhandler(businessexception.class)
    public map<string, object> handlebusinessexception(businessexception e) {
        map<string, object> result = new hashmap<>();
        result.put("code", e.getcode()); // 自定义错误码
        result.put("msg", e.getmsg()); // 自定义错误信息
        result.put("data", null);
        return result;
    }
    // 处理空指针异常（精准处理特定异常）
    @exceptionhandler(nullpointerexception.class)
    public map<string, object> handlenpe(nullpointerexception e) {
        map<string, object> result = new hashmap<>();
        result.put("code", 400);
        result.put("msg", "空指针异常：" + e.getmessage());
        result.put("data", null);
        return result;
    }
}
// 自定义业务异常（项目中建议创建，用于业务逻辑错误）
class businessexception extends runtimeexception {
    private integer code;
    private string msg;
    public businessexception(integer code, string msg) {
        super(msg);
        this.code = code;
        this.msg = msg;
    }
    public integer getcode() { return code; }
    public string getmsg() { return msg; }
}

使用自定义异常（业务层中抛出）

@service
public class userservice {
    public void deleteuser(long id) {
        if (id == null || id <= 0) {
            // 抛出自定义业务异常，由全局异常处理器处理
            throw new businessexception(400, "用户id不合法");
        }
        // 业务逻辑：删除用户
    }
}

3. 拦截器（interceptor）

核心作用

拦截接口请求，在请求处理前、处理后、视图渲染后（rest 接口无此步骤） 执行自定义逻辑，如登录验证、接口限流、日志记录、参数校验等。

实现步骤

实现handlerinterceptor接口，重写拦截方法；
在配置类中实现webmvcconfigurer接口，重写addinterceptors方法，注册拦截器并指定拦截 / 放行路径。

实战使用（登录验证拦截器）

// 步骤1：实现handlerinterceptor，编写拦截逻辑
import org.springframework.web.servlet.handlerinterceptor;
import javax.servlet.http.httpservletrequest;
import javax.servlet.http.httpservletresponse;
public class logininterceptor implements handlerinterceptor {
    // 核心方法：请求处理前执行（return true：放行，return false：拦截）
    @override
    public boolean prehandle(httpservletrequest request, httpservletresponse response, object handler) throws exception {
        // 逻辑：从请求头获取token，验证是否登录
        string token = request.getheader("token");
        if (token == null || token.isempty()) {
            // 未登录，返回401错误
            response.setstatus(401);
            response.getwriter().write("{\"code\":401, \"msg\":\"未登录，请先登录\", \"data\":null}");
            return false; // 拦截请求
        }
        // 登录验证通过，放行
        return true;
    }
    // 可选：请求处理后执行（控制器方法执行完，未返回响应前）
    @override
    public void posthandle(httpservletrequest request, httpservletresponse response, object handler, org.springframework.web.servlet.modelandview modelandview) throws exception {
        handlerinterceptor.super.posthandle(request, response, handler, modelandview);
    }
    // 可选：视图渲染后执行（rest接口无需实现）
    @override
    public void aftercompletion(httpservletrequest request, httpservletresponse response, object handler, exception ex) throws exception {
        handlerinterceptor.super.aftercompletion(request, response, handler, ex);
    }
}
// 步骤2：配置类中注册拦截器
import org.springframework.context.annotation.configuration;
import org.springframework.web.servlet.config.annotation.interceptorregistry;
import org.springframework.web.servlet.config.annotation.webmvcconfigurer;
@configuration
public class webmvcconfig implements webmvcconfigurer {
    // 注册拦截器
    @override
    public void addinterceptors(interceptorregistry registry) {
        registry.addinterceptor(new logininterceptor())
                .addpathpatterns("/**") // 拦截所有路径
                .excludepathpatterns("/user/login", "/user/register"); // 放行登录/注册接口
    }
}

4. 跨域配置（cors）

核心作用

解决前后端分离项目中的跨域问题（浏览器同源策略限制：协议、域名、端口任一不同即为跨域，如前端http://localhost:3000访问后端http://localhost:8081）。

实战实现（两种方式，推荐全局配置）

方式 1：全局跨域配置（推荐，作用于所有接口）

在webmvcconfig中重写addcorsmappings方法：

@configuration
public class webmvcconfig implements webmvcconfigurer {
    // 全局跨域配置
    @override
    public void addcorsmappings(corsregistry registry) {
        registry.addmapping("/**") // 允许所有路径跨域
                .allowedoriginpatterns("*") // 允许所有域名跨域（spring boot 2.4+替代allowedorigins("*")）
                .allowedmethods("get", "post", "put", "delete", "patch") // 允许的请求方式
                .allowedheaders("*") // 允许的请求头
                .allowcredentials(true) // 允许携带cookie
                .maxage(3600); // 预检请求有效期（秒），避免重复发送预检请求
    }
    // 拦截器注册...
}

方式 2：局部跨域配置（作用于单个接口 / 控制器）

用@crossorigin注解，标记在控制器 / 方法上：

// 控制器级别：该类所有接口允许跨域
@restcontroller
@requestmapping("/user")
@crossorigin(origins = "*", maxage = 3600)
public class usercontroller {
    // 方法级别：仅该接口允许跨域（覆盖控制器级别配置）
    @getmapping("/get/{id}")
    @crossorigin(origins = "http://localhost:3000")
    public string getuser(@pathvariable long id) {
        return "{\"id\":" + id + ", \"name\":\"张三\"}";
    }
}

三、数据访问核心组件（操作数据库必用）

spring boot 提供了多种数据访问组件，适配不同的数据库操作框架，最常用的是 mybatis-plus（简化 mybatis） 和spring data jpa（orm 框架），以下讲解基于mybatis-plus（企业开发主流，比原生 mybatis 少写 80% 代码）。

1. 核心依赖（mybatis-plus + 数据库驱动 + 连接池）

<!-- mybatis-plus starter（整合mybatis+自动配置） -->
<dependency>
    <groupid>com.baomidou</groupid>
    <artifactid>mybatis-plus-boot-starter</artifactid>
    <version>3.5.5</version> <!-- 最新稳定版 -->
</dependency>
<!-- mysql驱动（适配mysql8+，5.x需修改版本为5.1.49） -->
<dependency>
    <groupid>com.mysql</groupid>
    <artifactid>mysql-connector-j</artifactid>
    <scope>runtime</scope>
</dependency>
<!-- 阿里druid连接池（高性能，推荐，替代默认的hikaricp） -->
<dependency>
    <groupid>com.alibaba</groupid>
    <artifactid>druid-spring-boot-starter</artifactid>
    <version>1.2.20</version>
</dependency>

2. 数据库配置（application.yml）

配置数据库连接、mybatis-plus、连接池参数：

spring:
  # 数据库连接配置
  datasource:
    type: com.alibaba.druid.pool.druiddatasource # 指定druid连接池
    driver-class-name: com.mysql.cj.jdbc.driver # mysql8+驱动类
    url: jdbc:mysql://localhost:3306/test?useunicode=true&characterencoding=utf8&servertimezone=asia/shanghai&usessl=false
    username: root # 数据库用户名
    password: 123456 # 数据库密码
    # druid连接池配置
    druid:
      initial-size: 5 # 初始连接数
      min-idle: 5 # 最小空闲连接数
      max-active: 20 # 最大活跃连接数
      max-wait: 60000 # 最大等待时间（ms）
# mybatis-plus配置
mybatis-plus:
  mapper-locations: classpath:mapper/*.xml # mapper.xml文件路径（若用注解开发可省略）
  type-aliases-package: com.example.demo.entity # 实体类包名，简化xml中的类名
  configuration:
    map-underscore-to-camel-case: true # 开启下划线转驼峰（数据库user_name → 实体类username）
    log-impl: org.apache.ibatis.logging.stdout.stdoutimpl # 开启sql日志，方便调试

3. 核心注解与使用（mybatis-plus）

（1）实体类注解（@tablename/@tableid/@tablefield）

标记实体类与数据库表的映射关系：

import com.baomidou.mybatisplus.annotation.idtype;
import com.baomidou.mybatisplus.annotation.tableid;
import com.baomidou.mybatisplus.annotation.tablename;
// 映射数据库表：t_user（若实体类名与表名一致，可省略）
@tablename("t_user")
public class user {
    // 主键注解，type = idtype.auto：自增主键
    @tableid(type = idtype.auto)
    private long id;
    // 字段注解，若实体类属性与表字段名一致，可省略
    @tablefield("user_name")
    private string username;
    private integer age;
    private string email;
    // getter/setter...
}

（2）mapper 接口（继承 basemapper，零 sql 实现 crud）

mybatis-plus 的核心，继承basemapper<t>即可获得单表 crud 所有方法，无需手动编写 mapper 接口和 xml：

import com.baomidou.mybatisplus.core.mapper.basemapper;
import com.example.demo.entity.user;
import org.apache.ibatis.annotations.mapper;
// 标记为mybatis mapper，spring boot自动扫描并注册
@mapper
public interface usermapper extends basemapper<user> {
    // 无需编写任何方法，basemapper已提供所有单表crud
    // 若需复杂查询，可手动编写方法+xml/注解
}

（3）业务层使用（注入 mapper，直接调用方法）

import com.baomidou.mybatisplus.core.conditions.query.lambdaquerywrapper;
import com.example.demo.entity.user;
import com.example.demo.mapper.usermapper;
import org.springframework.beans.factory.annotation.autowired;
import org.springframework.stereotype.service;
import java.util.list;
@service
public class userservice {
    @autowired
    private usermapper usermapper;
    // 新增用户
    public boolean adduser(user user) {
        return usermapper.insert(user) > 0;
    }
    // 根据id查询用户
    public user getuserbyid(long id) {
        return usermapper.selectbyid(id);
    }
    // 条件查询：根据姓名模糊查询，年龄大于20
    public list<user> listuser(string name) {
        // lambdaquerywrapper：条件构造器，链式编程，避免硬编码字段名
        lambdaquerywrapper<user> wrapper = new lambdaquerywrapper<>();
        wrapper.like(user::getusername, name) // 姓名模糊查询
               .gt(user::getage, 20); // 年龄大于20
        return usermapper.selectlist(wrapper);
    }
    // 修改用户
    public boolean updateuser(user user) {
        return usermapper.updatebyid(user) > 0;
    }
    // 删除用户
    public boolean deleteuser(long id) {
        return usermapper.deletebyid(id) > 0;
    }
}

4. 事务管理（@transactional）

核心作用

保证多个数据库操作的原子性（要么全部成功，要么全部失败），避免出现数据不一致（如转账时扣了 a 的钱，没加 b 的钱）。

实战使用

标记在服务层方法上（必须在服务层，控制器层无效），spring 会自动为该方法添加事务支持：

@service
public class userservice {
    @autowired
    private usermapper usermapper;
    // 新增用户并记录日志，开启事务
    // rollbackfor = exception.class：所有异常都回滚（默认仅运行时异常回滚）
    @transactional(rollbackfor = exception.class)
    public boolean adduserandlog(user user) {
        // 操作1：新增用户
        usermapper.insert(user);
        // 模拟异常：若出现异常，事务回滚，用户不会被新增
        // int i = 1 / 0;
        // 操作2：记录日志（假设有logmapper）
        // logmapper.insert(new log("新增用户：" + user.getusername()));
        return true;
    }
}

核心属性

rollbackfor = exception.class：指定所有异常都回滚（默认仅runtimeexception和error回滚，编译时异常如ioexception不回滚，建议必加）；
propagation：事务传播行为（如required：默认，有事务则加入，无则新建；supports：有事务则加入，无则无事务）；
readonly = true：只读事务（仅查询，提升性能）。

四、常用辅助组件（提升开发效率）

1. 热部署（spring-boot-starter-devtools）

核心作用

修改代码 / 配置后，无需手动重启项目，自动重启 spring boot 应用，提升开发效率（仅开发环境使用，生产环境禁用）。

依赖与配置

<!-- 热部署依赖 -->
<dependency>
    <groupid>org.springframework.boot</groupid>
    <artifactid>spring-boot-starter-devtools</artifactid>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>

yml 配置（可选，优化热部署）：

spring:
  devtools:
    restart:
      enabled: true # 开启热部署
      additional-paths: src/main/java # 监听的代码目录
      exclude: static/**,templates/** # 排除的目录（静态资源/视图，修改后无需重启）

idea 配置（必做，否则热部署不生效）：

开启自动编译：file → settings → build, execution, deployment → compiler → 勾选build project automatically；
开启高级自动编译：按住ctrl+alt+shift+/ → 选择 registry → 勾选compiler.automake.allow.when.app.running。

2. lombok（简化代码，消除样板代码）

核心作用

通过注解替代 java 中繁琐的getter/setter/tostring/ 构造方法，减少代码量，提升开发效率（需安装 idea lombok 插件）。

核心依赖与注解

<!-- lombok依赖 -->
<dependency>
    <groupid>org.projectlombok</groupid>
    <artifactid>lombok</artifactid>
    <optional>true</optional>
</dependency>

常用注解（标记在实体类上）：

import com.baomidou.mybatisplus.annotation.idtype;
import com.baomidou.mybatisplus.annotation.tableid;
import com.baomidou.mybatisplus.annotation.tablename;
import lombok.data;
import lombok.noargsconstructor;
import lombok.allargsconstructor;
import lombok.tostring;
@tablename("t_user")
@data // 自动生成getter/setter/equals/hashcode/tostring
@noargsconstructor // 自动生成无参构造方法
@allargsconstructor // 自动生成全参构造方法
// @tostring // 单独生成tostring（@data已包含）
public class user {
    @tableid(type = idtype.auto)
    private long id;
    private string username;
    private integer age;
    private string email;
}

其他常用注解：

@slf4j：自动生成日志对象log，替代loggerfactory.getlogger(类名.class)；
@builder：开启建造者模式，可通过user.builder().id(1l).username("张三").build()创建对象；
@nonnull：标记字段为非空，赋值为 null 时抛出空指针异常。

3. 接口文档（knife4j，替代 swagger）

核心作用

自动生成restful 接口文档，支持在线调试、接口测试、文档导出，替代传统的 word 文档，实现接口文档与代码同步更新（swagger3 的增强版，更适配 spring boot 3+）。

核心依赖与配置

<!-- knife4j starter（整合swagger3，适配spring boot 3+） -->
<dependency>
    <groupid>com.github.xiaoymin</groupid>
    <artifactid>knife4j-spring-boot-starter</artifactid>
    <version>4.4.0</version> <!-- 最新稳定版 -->
</dependency>

配置类（开启 swagger3）：

import com.github.xiaoymin.knife4j.spring.annotations.enableknife4j;
import org.springframework.context.annotation.bean;
import org.springframework.context.annotation.configuration;
import org.springframework.web.servlet.config.annotation.enablewebmvc;
import io.swagger.v3.oas.models.openapi;
import io.swagger.v3.oas.models.info.info;
@configuration
@enablewebmvc
@enableknife4j // 开启knife4j增强功能
public class knife4jconfig {
    // 配置接口文档基本信息
    @bean
    public openapi openapi() {
        return new openapi()
                .info(new info()
                        .title("spring boot组件演示接口文档")
                        .description("spring boot核心组件实战接口")
                        .version("1.0.0"));
    }
}

yml 配置（开发环境开启，生产环境关闭）：

knife4j:
  enable: true # 开启knife4j
  openapi:
    title: spring boot组件演示接口文档
    description: 核心组件实战接口
    version: 1.0.0
spring:
  profiles:
    active: dev # 开发环境开启，生产环境改为prod并设置knife4j.enable=false

接口注解（标记接口 / 参数，生成更详细的文档）

import io.swagger.v3.oas.annotations.operation;
import io.swagger.v3.oas.annotations.parameter;
import io.swagger.v3.oas.annotations.parameters;
import org.springframework.web.bind.annotation.getmapping;
import org.springframework.web.bind.annotation.pathvariable;
import org.springframework.web.bind.annotation.requestmapping;
import org.springframework.web.bind.annotation.restcontroller;
@restcontroller
@requestmapping("/user")
public class usercontroller {
    // 接口描述
    @operation(summary = "根据id查询用户", description = "传入用户id，返回用户详细信息")
    // 参数描述
    @parameters({@parameter(name = "id", description = "用户id", required = true)})
    @getmapping("/get/{id}")
    public user getuser(@pathvariable long id) {
        return new user(id, "张三", 25, "zhangsan@163.com");
    }
}

访问文档

项目启动后，访问：http://localhost:8081/doc.html（替换为自己的端口 / 上下文路径），即可看到接口文档，支持在线调试（直接填写参数，点击 “发送” 即可测试接口）。

五、spring boot 组件核心配合逻辑（一张图理解）

plaintext

┌─────────────────────────────────────────────────────────┐
│  客户端请求（浏览器/前端/postman）                        │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│  服务器（tomcat，由spring-boot-starter-web自动嵌入）     │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│  拦截器（interceptor）：登录验证/日志记录/限流            │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│  控制器（@restcontroller）：接收请求/参数绑定/返回响应    │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│  服务层（@service）：业务逻辑处理 + 事务管理（@transactional）│
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│  数据访问层（@mapper/mybatis-plus）：操作数据库          │
└───────────────────────────┬─────────────────────────────┘
                            │
┌───────────────────────────▼─────────────────────────────┐
│  数据库（mysql/redis）                                   │
└─────────────────────────────────────────────────────────┘

全局组件兜底：

全局异常处理器（@restcontrolleradvice）：捕获所有环节的异常，返回统一 json；
配置文件（application.yml）：覆盖所有组件的默认配置；
spring ioc 容器：管理所有 bean，实现依赖注入和解耦。

六、总结（核心关键点）

spring boot 核心思想：约定大于配置，通过starter 起步依赖和自动配置消除繁琐配置，专注业务开发；
基础三件套：主启动类（@springbootapplication）+ 配置文件（application.yml）+ 核心注解（bean 注册 / 依赖注入），所有项目必用；
web 开发核心：@restcontroller 实现 restful 接口，@restcontrolleradvice 实现全局异常处理，interceptor 实现请求拦截，cors 解决跨域；
数据访问核心：mybatis-plus 简化数据库操作，@transactional 保证事务原子性，druid 作为高性能连接池；
效率提升组件：lombok 消除样板代码，devtools 实现热部署，knife4j 自动生成接口文档，都是企业开发必备；
核心原则：
- 所有组件通过starter引入，避免手动管理依赖；
- 所有自定义 bean 通过 **@configuration + @bean** 声明，或通过 @component 系列注解注册；
- 所有依赖通过 **@autowired/@resource** 注入，无需手动 new，实现解耦；
- 开发环境与生产环境通过多环境配置分离，避免配置混用。

以上就是 spring boot 最核心、最常用的组件使用详解，覆盖了从基础项目搭建到后端接口开发、数据库操作、效率提升的全流程，所有代码都可直接复制到 spring boot 3.2.x 项目中使用，适配企业开发的主流场景。

到此这篇关于spring boot 3x 框架核心组件的使用详解的文章就介绍到这了,更多相关spring boot 3x 框架使用内容请搜索代码网以前的文章或继续浏览下面的相关文章希望大家以后多多支持代码网！


验证码：

Spring Boot 3X 框架核心组件的使用详解

2026年02月12日 • Java •我要评论

前置基础

一、核心基础组件（所有项目必用）

1. starter 起步依赖（组件入口）

核心作用

核心设计

实战使用（pom.xml）

2. 主启动类（@springbootapplication）

核心作用

核心注解拆解（@springbootapplication 是复合注解）

实战使用（主启动类代码）

关键注意

3. 配置文件（application.yml/properties）

核心作用

配置优先级

核心使用

4. 核心注解（bean 注册与依赖注入）

（1）bean 注册注解（将类交给 spring 管理）

（2）依赖注入注解（从 spring 容器中获取 bean）

（3）自定义 bean 声明（@bean）

二、web 开发核心组件（后端接口必用）

1. @restcontroller & @controller（请求处理核心）

核心区别

实战使用（restful 接口）

核心请求注解（@getmapping/@postmapping 等）

2. 全局异常处理（@restcontrolleradvice + @exceptionhandler）

核心作用

核心注解

实战使用（统一异常返回）

使用自定义异常（业务层中抛出）

3. 拦截器（interceptor）

核心作用

实现步骤

实战使用（登录验证拦截器）

4. 跨域配置（cors）

核心作用

实战实现（两种方式，推荐全局配置）

三、数据访问核心组件（操作数据库必用）

1. 核心依赖（mybatis-plus + 数据库驱动 + 连接池）

2. 数据库配置（application.yml）

3. 核心注解与使用（mybatis-plus）

（1）实体类注解（@tablename/@tableid/@tablefield）

（2）mapper 接口（继承 basemapper，零 sql 实现 crud）

（3）业务层使用（注入 mapper，直接调用方法）

4. 事务管理（@transactional）

核心作用

实战使用

核心属性

四、常用辅助组件（提升开发效率）

1. 热部署（spring-boot-starter-devtools）

核心作用

依赖与配置

2. lombok（简化代码，消除样板代码）

核心作用

核心依赖与注解

3. 接口文档（knife4j，替代 swagger）

核心作用

核心依赖与配置

接口注解（标记接口 / 参数，生成更详细的文档）

访问文档

五、spring boot 组件核心配合逻辑（一张图理解）

六、总结（核心关键点）

相关文章:

Tomcat在日志、页面和idea控制台的中文乱码问题及解决方案

jenkins持续自动化发布、集成实践

发表评论