Spring Boot 是一个用于简化 Spring 应用初始搭建和开发过程的开源 Java 框架。它通过“约定大于配置”的理念，集成了大量默认配置和第三方库，使开发者能够快速创建独立运行、生产级的 Spring 应用程序。

一、 核心特性与优势

二、 项目创建与结构

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.port=8080 server.servlet.context-path=/myapp # 数据源配置 spring.datasource.url=jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC spring.datasource.username=root spring.datasource.password=123456 spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver # MyBatis 配置mybatis.mapper-locations=classpath:mapper/*.xml mybatis.type-aliases-package=com.example.demo.entity

application.yml 等效配置：

server: port: 8080 servlet: context-path: /myappspring: datasource: url: jdbc:mysql://localhost:3306/testdb?useSSL=false&serverTimezone=UTC username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver mybatis: mapper-locations: classpath:mapper/*.xml type-aliases-package: com.example.demo.entity

2. 多环境配置

通过命名约定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: dev

3. 读取自定义配置

• 使用@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 List<String> servers = new ArrayList<>(); }

  # application.yml myapp: name: "Demo Application" version: "1.0.0" servers:

"server1"
"server2"
```

四、 Web 开发集成

1. 开发 RESTful API

Spring Boot 通过spring-boot-starter-web自动配置 Spring MVC。

@RestController // 组合了 @Controller 和 @ResponseBody @RequestMapping("/api/users") public class UserController { @Autowired private UserService userService; @GetMapping("/{id}") public ResponseEntity<User> getUserById(@PathVariable Long id) { User user = userService.getUserById(id); return ResponseEntity.ok(user); // 自动序列化为 JSON } @PostMapping public ResponseEntity<User> createUser(@RequestBody @Valid User user) { User savedUser = userService.createUser(user); return ResponseEntity.status(HttpStatus.CREATED).body(savedUser); } @PutMapping("/{id}") public ResponseEntity<User> updateUser(@PathVariable Long id, @RequestBody User user) { user.setId(id); User updatedUser = userService.updateUser(user); return ResponseEntity.ok(updatedUser); } @DeleteMapping("/{id}") public ResponseEntity<Void> deleteUser(@PathVariable Long id) { userService.deleteUser(id); return ResponseEntity.noContent().build(); } }

2. 集成 MyBatis

1. 添加依赖：

   <groupId>org.mybatis.spring.boot</groupId> <artifactId>mybatis-spring-boot-starter</artifactId> <version>3.0.3</version> </dependency> <dependency> <groupId>com.mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency>

2. 配置数据源和 MyBatis（见上文核心配置部分）。
3. 创建实体类、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 version="1.0" encoding="UTF-8" ?> <!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd"> <mapper namespace="com.example.demo.mapper.UserMapper"> <select id="selectById" resultType="User"> SELECT * FROM user WHERE id = #{id} </select> <insert id="insert" useGeneratedKeys="true" keyProperty="id"> INSERT INTO user(name, email) VALUES(#{name}, #{email}) </insert> </mapper>

4. 在 Service 中注入 Mapper 使用。

3. 集成 Spring Data JPA

1. 添加依赖：

   <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-jpa</artifactId> </dependency>

2. 配置数据源（同上）。
3. 定义实体和仓库接口：

   // User.java @Entity @Data @Table(name = "user") public class User { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) private Long id; private String name; private String email; }

   // 可根据方法名自动生成查询 List<User> findByName(String name); Optional<User> findByEmail(String email); }

4. 在 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})
• 覆盖自动配置：在配置类中显式定义@Bean，Spring 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 ResponseEntity<ErrorResponse> handleAllExceptions(Exception ex) { ErrorResponse error = new ErrorResponse(HttpStatus.INTERNAL_SERVER_ERROR.value(), "服务器内部错误"); return new ResponseEntity<>(error, HttpStatus.INTERNAL_SERVER_ERROR); } @ExceptionHandler(ResourceNotFoundException.class) public ResponseEntity<ErrorResponse> 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）。

@SpringBootTest@AutoConfigureMockMvc 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 --> <packaging>war</packaging>

六、 常用 Starter 依赖列表

通过遵循上述指南，你可以系统地掌握 Spring Boot 的核心概念、开发流程和高级特性，从而高效地构建健壮的 Java 后端应用。

参考来源

• SpringBoot框架
• Spring Boot 框架详细指南
• Spring Boot框架总结（超级详细）
• Spring Boot框架知识总结（超详细）
• Spring Boot框架总结（超级详细）
• Spring Boot框架总结（超级详细）