Spring Boot 是一个用于简化 Spring 应用初始搭建和开发过程的开源 Java 框架。它通过“约定大于配置”的理念集成了大量默认配置和第三方库使开发者能够快速创建独立运行、生产级的 Spring 应用程序。一、 核心特性与优势特性描述解决的问题自动配置根据项目类路径下的依赖自动配置 Spring 应用所需的 Bean。消除了传统 Spring 项目中大量的 XML 或 Java 配置。起步依赖预定义的依赖描述符聚合了开发某一功能所需的所有库。简化 Maven/Gradle 配置解决依赖版本冲突问题。内嵌服务器默认内嵌 Tomcat、Jetty 或 Undertow 等 Web 容器。无需打包为 WAR 文件部署到外部服务器可直接运行 Jar 包。生产就绪提供健康检查、指标、外部化配置等生产级特性。简化了应用的监控和管理。二、 项目创建与结构1. 项目创建推荐使用Spring Initializr可通过 start.spring.io 或 IDE 集成快速生成项目骨架。创建时需选择项目类型Maven 或 Gradle。语言Java、Kotlin 或 Groovy。Spring Boot 版本建议选择当前稳定版。项目元数据Group、Artifact、包名等。依赖根据项目需要选择如Spring Web,Spring Data JPA,MyBatis Framework,MySQL Driver等。2. 标准项目结构src/main/java └── com.example.demo ├── DemoApplication.java # 主启动类包含 SpringBootApplication 注解 ├── controller/ # 控制器层 ├── service/ # 业务逻辑层 ├── dao/repository/ # 数据访问层 └── entity/domain/ # 实体类 src/main/resources ├── static/ # 静态资源CSS, JS, 图片 ├── templates/ # 模板文件Thymeleaf, Freemarker ├── application.properties # 主配置文件或 application.yml └── mapper/ # MyBatis 映射文件如使用 src/test/java # 测试代码 pom.xml / build.gradle # 项目依赖管理文件三、 核心配置详解1. 配置文件格式Spring Boot 支持两种配置文件格式application.properties和application.yml。后者采用缩进结构更简洁。application.properties 示例# 服务器配置 server.port8080 server.servlet.context-path/myapp # 数据源配置 spring.datasource.urljdbc:mysql://localhost:3306/testdb?useSSLfalseserverTimezoneUTC spring.datasource.usernameroot spring.datasource.password123456 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver # MyBatis 配置mybatis.mapper-locationsclasspath:mapper/*.xml mybatis.type-aliases-packagecom.example.demo.entityapplication.yml 等效配置server: port: 8080 servlet: context-path: /myappspring: datasource: url: jdbc:mysql://localhost:3306/testdb?useSSLfalseserverTimezoneUTC username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.demo.entity2. 多环境配置通过命名约定application-{profile}.properties/yml来区分不同环境如开发、测试、生产并在主配置文件中激活。# application-dev.yml server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/devdb # application-prod.yml server: port: 80 spring: datasource: url: jdbc:mysql://prod-server:3306/proddb # application.yml (主配置激活开发环境) spring: profiles: active: dev3. 读取自定义配置使用Value注解适用于读取单个、分散的配置项。Component public class MyComponent { Value(${custom.property.name}) private String propertyName; Value(${server.port}) private int port; }使用ConfigurationProperties注解将一组配置绑定到一个 Java Bean 上适用于结构化配置。Data // Lombok 注解生成 getter/setter public class MyAppProperties { private String name; private String version; private ListString servers new ArrayList(); }# application.yml myapp: name: Demo Application version: 1.0.0 servers:server1server2四、 Web 开发集成1. 开发 RESTful APISpring Boot 通过spring-boot-starter-web自动配置 Spring MVC。RestController // 组合了 Controller 和 ResponseBody RequestMapping(/api/users) public class UserController { Autowired private UserService userService; GetMapping(/{id}) public ResponseEntityUser getUserById(PathVariable Long id) { User user userService.getUserById(id); return ResponseEntity.ok(user); // 自动序列化为 JSON } PostMapping public ResponseEntityUser createUser(RequestBody Valid User user) { User savedUser userService.createUser(user); return ResponseEntity.status(HttpStatus.CREATED).body(savedUser); } PutMapping(/{id}) public ResponseEntityUser updateUser(PathVariable Long id, RequestBody User user) { user.setId(id); User updatedUser userService.updateUser(user); return ResponseEntity.ok(updatedUser); } DeleteMapping(/{id}) public ResponseEntityVoid deleteUser(PathVariable Long id) { userService.deleteUser(id); return ResponseEntity.noContent().build(); } }2. 集成 MyBatis添加依赖groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency配置数据源和 MyBatis见上文核心配置部分。创建实体类、Mapper 接口和 XML 映射文件// User.java Data public class User { private Long id; private String name; private String email; }// UserMapper.java Mapper // 或在主类上加 MapperScan public interface UserMapper { User selectById(Param(id) Long id); int insert(User user); int update(User user); int deleteById(Param(id) Long id); }!-- UserMapper.xml -- ?xml version1.0 encodingUTF-8 ? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.demo.mapper.UserMapper select idselectById resultTypeUser SELECT * FROM user WHERE id #{id} /select insert idinsert useGeneratedKeystrue keyPropertyid INSERT INTO user(name, email) VALUES(#{name}, #{email}) /insert /mapper在 Service 中注入 Mapper 使用。3. 集成 Spring Data JPA添加依赖groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /dependency配置数据源同上。定义实体和仓库接口// User.java Entity Data Table(name user) public class User { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; private String name; private String email; }// 可根据方法名自动生成查询 ListUser findByName(String name); OptionalUser findByEmail(String email); }在 Service 中注入 Repository 使用。4. 事务管理在 Service 层方法上使用Transactional注解即可声明事务。Service public class UserService { Autowired private UserRepository userRepository; Transactional // 此方法将在一个事务中执行 public User createUser(User user) { // 一些业务逻辑... return userRepository.save(user); } }五、 高级特性与最佳实践1. 自动配置原理与定制自动配置的核心是SpringBootApplication注解和spring.factories文件。其条件化装配逻辑由ConditionalOnXxx系列注解如ConditionalOnClass,ConditionalOnMissingBean控制。排除自动配置SpringBootApplication(exclude {DataSourceAutoConfiguration.class})覆盖自动配置在配置类中显式定义BeanSpring Boot 会优先使用用户定义的 Bean。2. 日志配置Spring Boot 默认使用 Logback 日志框架。可通过application.yml配置logging: level: root: INFO com.example.demo: DEBUG # 指定包下的日志级别 file: name: logs/myapp.log # 输出到文件 pattern: console: %d{yyyy-MM-dd HH:mm:ss} - %msg%n # 控制台输出格式3. 异常处理使用ControllerAdvice或RestControllerAdvice进行全局异常处理。RestControllerAdvice public class GlobalExceptionHandler { ExceptionHandler(Exception.class) public ResponseEntityErrorResponse handleAllExceptions(Exception ex) { ErrorResponse error new ErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR.value(), 服务器内部错误); return new ResponseEntity(error, HttpStatus.INTERNAL_SERVER_ERROR); } ExceptionHandler(ResourceNotFoundException.class) public ResponseEntityErrorResponse handleResourceNotFound(ResourceNotFoundException ex) { ErrorResponse error new ErrorResponse(HttpStatus.NOT_FOUND.value(), ex.getMessage()); return new ResponseEntity(error, HttpStatus.NOT_FOUND); } }4. 单元测试Spring Boot 提供了强大的测试支持spring-boot-starter-test。SpringBootTestAutoConfigureMockMvc class UserControllerTest { Autowired private MockMvc mockMvc; Test void getUserById_ShouldReturnUser() throws Exception { mockMvc.perform(get(/api/users/1)) .andExpect(status().isOk()) .andExpect(jsonPath($.name).value(张三)); } }5. 打包与部署使用 Spring Boot Maven/Gradle 插件可将应用打包为可执行的 JAR 或 WAR 文件。打包为可执行 JAR默认直接运行java -jar your-app.jar。打包为 WAR需将主类继承SpringBootServletInitializer并修改打包方式。SpringBootApplication public class DemoApplication extends SpringBootServletInitializer { Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(DemoApplication.class); } public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }!-- pom.xml -- packagingwar/packaging六、 常用 Starter 依赖列表Starter功能描述主要包含的依赖spring-boot-starter-web构建 Web 应用包含 RESTful、Spring MVC、内嵌 Tomcatspring-webmvc, tomcat-embed, jacksonspring-boot-starter-data-jpa使用 Spring Data JPA 和 Hibernatespring-data-jpa, hibernate-corespring-boot-starter-data-redis使用 Redis 进行数据存储和缓存spring-data-redis, lettuce-corespring-boot-starter-security使用 Spring Security 进行认证和授权spring-security-web, spring-security-configspring-boot-starter-test用于测试包含 JUnit, Hamcrest, Mockitojunit, spring-test, mockito-corespring-boot-starter-thymeleaf使用 Thymeleaf 模板引擎构建 MVC Web 应用thymeleaf, thymeleaf-spring5spring-boot-starter-aop使用 Spring AOP 和 AspectJ进行面向切面编程spring-aop, aspectjweaverspring-boot-starter-actuator提供生产就绪功能如健康检查、指标收集spring-boot-actuator通过遵循上述指南你可以系统地掌握 Spring Boot 的核心概念、开发流程和高级特性从而高效地构建健壮的 Java 后端应用。参考来源SpringBoot框架Spring Boot 框架详细指南Spring Boot框架总结超级详细Spring Boot框架知识总结超详细Spring Boot框架总结超级详细Spring Boot框架总结超级详细
Spring Boot 是一个用于简化 Spring 应用初始搭建和开发过程的开源 Java 框架。它通过“约定大于配置”的理念集成了大量默认配置和第三方库使开发者能够快速创建独立运行、生产级的 Spring 应用程序。一、 核心特性与优势特性描述解决的问题自动配置根据项目类路径下的依赖自动配置 Spring 应用所需的 Bean。消除了传统 Spring 项目中大量的 XML 或 Java 配置。起步依赖预定义的依赖描述符聚合了开发某一功能所需的所有库。简化 Maven/Gradle 配置解决依赖版本冲突问题。内嵌服务器默认内嵌 Tomcat、Jetty 或 Undertow 等 Web 容器。无需打包为 WAR 文件部署到外部服务器可直接运行 Jar 包。生产就绪提供健康检查、指标、外部化配置等生产级特性。简化了应用的监控和管理。二、 项目创建与结构1. 项目创建推荐使用Spring Initializr可通过 start.spring.io 或 IDE 集成快速生成项目骨架。创建时需选择项目类型Maven 或 Gradle。语言Java、Kotlin 或 Groovy。Spring Boot 版本建议选择当前稳定版。项目元数据Group、Artifact、包名等。依赖根据项目需要选择如Spring Web,Spring Data JPA,MyBatis Framework,MySQL Driver等。2. 标准项目结构src/main/java └── com.example.demo ├── DemoApplication.java # 主启动类包含 SpringBootApplication 注解 ├── controller/ # 控制器层 ├── service/ # 业务逻辑层 ├── dao/repository/ # 数据访问层 └── entity/domain/ # 实体类 src/main/resources ├── static/ # 静态资源CSS, JS, 图片 ├── templates/ # 模板文件Thymeleaf, Freemarker ├── application.properties # 主配置文件或 application.yml └── mapper/ # MyBatis 映射文件如使用 src/test/java # 测试代码 pom.xml / build.gradle # 项目依赖管理文件三、 核心配置详解1. 配置文件格式Spring Boot 支持两种配置文件格式application.properties和application.yml。后者采用缩进结构更简洁。application.properties 示例# 服务器配置 server.port8080 server.servlet.context-path/myapp # 数据源配置 spring.datasource.urljdbc:mysql://localhost:3306/testdb?useSSLfalseserverTimezoneUTC spring.datasource.usernameroot spring.datasource.password123456 spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver # MyBatis 配置mybatis.mapper-locationsclasspath:mapper/*.xml mybatis.type-aliases-packagecom.example.demo.entityapplication.yml 等效配置server: port: 8080 servlet: context-path: /myappspring: datasource: url: jdbc:mysql://localhost:3306/testdb?useSSLfalseserverTimezoneUTC username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.demo.entity2. 多环境配置通过命名约定application-{profile}.properties/yml来区分不同环境如开发、测试、生产并在主配置文件中激活。# application-dev.yml server: port: 8080 spring: datasource: url: jdbc:mysql://localhost:3306/devdb # application-prod.yml server: port: 80 spring: datasource: url: jdbc:mysql://prod-server:3306/proddb # application.yml (主配置激活开发环境) spring: profiles: active: dev3. 读取自定义配置使用Value注解适用于读取单个、分散的配置项。Component public class MyComponent { Value(${custom.property.name}) private String propertyName; Value(${server.port}) private int port; }使用ConfigurationProperties注解将一组配置绑定到一个 Java Bean 上适用于结构化配置。Data // Lombok 注解生成 getter/setter public class MyAppProperties { private String name; private String version; private ListString servers new ArrayList(); }# application.yml myapp: name: Demo Application version: 1.0.0 servers:server1server2四、 Web 开发集成1. 开发 RESTful APISpring Boot 通过spring-boot-starter-web自动配置 Spring MVC。RestController // 组合了 Controller 和 ResponseBody RequestMapping(/api/users) public class UserController { Autowired private UserService userService; GetMapping(/{id}) public ResponseEntityUser getUserById(PathVariable Long id) { User user userService.getUserById(id); return ResponseEntity.ok(user); // 自动序列化为 JSON } PostMapping public ResponseEntityUser createUser(RequestBody Valid User user) { User savedUser userService.createUser(user); return ResponseEntity.status(HttpStatus.CREATED).body(savedUser); } PutMapping(/{id}) public ResponseEntityUser updateUser(PathVariable Long id, RequestBody User user) { user.setId(id); User updatedUser userService.updateUser(user); return ResponseEntity.ok(updatedUser); } DeleteMapping(/{id}) public ResponseEntityVoid deleteUser(PathVariable Long id) { userService.deleteUser(id); return ResponseEntity.noContent().build(); } }2. 集成 MyBatis添加依赖groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-java/artifactId scoperuntime/scope /dependency配置数据源和 MyBatis见上文核心配置部分。创建实体类、Mapper 接口和 XML 映射文件// User.java Data public class User { private Long id; private String name; private String email; }// UserMapper.java Mapper // 或在主类上加 MapperScan public interface UserMapper { User selectById(Param(id) Long id); int insert(User user); int update(User user); int deleteById(Param(id) Long id); }!-- UserMapper.xml -- ?xml version1.0 encodingUTF-8 ? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.demo.mapper.UserMapper select idselectById resultTypeUser SELECT * FROM user WHERE id #{id} /select insert idinsert useGeneratedKeystrue keyPropertyid INSERT INTO user(name, email) VALUES(#{name}, #{email}) /insert /mapper在 Service 中注入 Mapper 使用。3. 集成 Spring Data JPA添加依赖groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-data-jpa/artifactId /dependency配置数据源同上。定义实体和仓库接口// User.java Entity Data Table(name user) public class User { Id GeneratedValue(strategy GenerationType.IDENTITY) private Long id; private String name; private String email; }// 可根据方法名自动生成查询 ListUser findByName(String name); OptionalUser findByEmail(String email); }在 Service 中注入 Repository 使用。4. 事务管理在 Service 层方法上使用Transactional注解即可声明事务。Service public class UserService { Autowired private UserRepository userRepository; Transactional // 此方法将在一个事务中执行 public User createUser(User user) { // 一些业务逻辑... return userRepository.save(user); } }五、 高级特性与最佳实践1. 自动配置原理与定制自动配置的核心是SpringBootApplication注解和spring.factories文件。其条件化装配逻辑由ConditionalOnXxx系列注解如ConditionalOnClass,ConditionalOnMissingBean控制。排除自动配置SpringBootApplication(exclude {DataSourceAutoConfiguration.class})覆盖自动配置在配置类中显式定义BeanSpring Boot 会优先使用用户定义的 Bean。2. 日志配置Spring Boot 默认使用 Logback 日志框架。可通过application.yml配置logging: level: root: INFO com.example.demo: DEBUG # 指定包下的日志级别 file: name: logs/myapp.log # 输出到文件 pattern: console: %d{yyyy-MM-dd HH:mm:ss} - %msg%n # 控制台输出格式3. 异常处理使用ControllerAdvice或RestControllerAdvice进行全局异常处理。RestControllerAdvice public class GlobalExceptionHandler { ExceptionHandler(Exception.class) public ResponseEntityErrorResponse handleAllExceptions(Exception ex) { ErrorResponse error new ErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR.value(), 服务器内部错误); return new ResponseEntity(error, HttpStatus.INTERNAL_SERVER_ERROR); } ExceptionHandler(ResourceNotFoundException.class) public ResponseEntityErrorResponse handleResourceNotFound(ResourceNotFoundException ex) { ErrorResponse error new ErrorResponse(HttpStatus.NOT_FOUND.value(), ex.getMessage()); return new ResponseEntity(error, HttpStatus.NOT_FOUND); } }4. 单元测试Spring Boot 提供了强大的测试支持spring-boot-starter-test。SpringBootTestAutoConfigureMockMvc class UserControllerTest { Autowired private MockMvc mockMvc; Test void getUserById_ShouldReturnUser() throws Exception { mockMvc.perform(get(/api/users/1)) .andExpect(status().isOk()) .andExpect(jsonPath($.name).value(张三)); } }5. 打包与部署使用 Spring Boot Maven/Gradle 插件可将应用打包为可执行的 JAR 或 WAR 文件。打包为可执行 JAR默认直接运行java -jar your-app.jar。打包为 WAR需将主类继承SpringBootServletInitializer并修改打包方式。SpringBootApplication public class DemoApplication extends SpringBootServletInitializer { Override protected SpringApplicationBuilder configure(SpringApplicationBuilder application) { return application.sources(DemoApplication.class); } public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }!-- pom.xml -- packagingwar/packaging六、 常用 Starter 依赖列表Starter功能描述主要包含的依赖spring-boot-starter-web构建 Web 应用包含 RESTful、Spring MVC、内嵌 Tomcatspring-webmvc, tomcat-embed, jacksonspring-boot-starter-data-jpa使用 Spring Data JPA 和 Hibernatespring-data-jpa, hibernate-corespring-boot-starter-data-redis使用 Redis 进行数据存储和缓存spring-data-redis, lettuce-corespring-boot-starter-security使用 Spring Security 进行认证和授权spring-security-web, spring-security-configspring-boot-starter-test用于测试包含 JUnit, Hamcrest, Mockitojunit, spring-test, mockito-corespring-boot-starter-thymeleaf使用 Thymeleaf 模板引擎构建 MVC Web 应用thymeleaf, thymeleaf-spring5spring-boot-starter-aop使用 Spring AOP 和 AspectJ进行面向切面编程spring-aop, aspectjweaverspring-boot-starter-actuator提供生产就绪功能如健康检查、指标收集spring-boot-actuator通过遵循上述指南你可以系统地掌握 Spring Boot 的核心概念、开发流程和高级特性从而高效地构建健壮的 Java 后端应用。参考来源SpringBoot框架Spring Boot 框架详细指南Spring Boot框架总结超级详细Spring Boot框架知识总结超详细Spring Boot框架总结超级详细Spring Boot框架总结超级详细
