这次我们来看一套完整的 SpringBoot 实战教程特别适合需要快速上手 Java 微服务开发的初学者和面试准备者。这套教程号称45分钟速通重点不是概念堆砌而是能不能在本地环境快速跑起来、理解核心配置、完成基础功能开发。如果你关心 SpringBoot 的实际部署、项目结构、自动配置原理、接口开发、数据库整合和微服务架构基础这篇文章可以直接收藏。我们会从环境准备开始完成一个可运行的 SpringBoot 项目测试基础接口整合 MyBatis 操作数据库最后讨论微服务架构的核心要点。本文适合有一定 Java 基础但 SpringBoot 经验不多的开发者或者需要复习 SpringBoot 核心知识的面试准备者。我们将使用 IntelliJ IDEA 作为开发工具MySQL 作为数据库Maven 进行依赖管理。1. SpringBoot 核心能力速览能力项说明学习门槛需要基本 Java 基础了解 MVC 概念更佳开发工具IntelliJ IDEA社区版即可依赖管理Maven 或 Gradle内嵌服务器Tomcat默认、Jetty、Undertow启动方式主类直接运行、命令行 mvn spring-boot:run配置方式application.properties/yml 自动加载数据库支持MySQL、PostgreSQL、H2 等整合 MyBatis/JPA微服务能力Spring Cloud 生态基础服务发现、配置中心适合场景快速原型开发、微服务入门、企业级应用基础SpringBoot 最大的优势是约定大于配置大部分通用配置已经预设好开发者只需关注业务逻辑。下面我们通过实际项目来验证这些能力。2. SpringBoot 适用场景与使用边界SpringBoot 特别适合以下场景快速原型开发内嵌 Tomcat 和自动配置让项目能在几分钟内启动运行微服务入门为后续学习 Spring Cloud 提供技术基础企业级应用提供完整的生产就绪功能健康检查、指标监控等面试准备覆盖大部分 Java 后端面试的 SpringBoot 相关问题但不适合超简单静态网站过度工程化轻量级框架更合适性能极致要求的场景内嵌服务器和自动配置有一定开销完全自定义的架构SpringBoot 的约定可能限制特殊需求在使用过程中要注意代码规范和企业级开发的最佳实践避免因快速开发而忽视软件质量。3. 环境准备与前置条件开始前请确保本地环境满足以下要求操作系统要求Windows 10/11、macOS 10.14 或 Linux Ubuntu 18.04至少 8GB 内存推荐 16GB至少 10GB 可用磁盘空间开发工具安装JDK 17长期支持版本# 验证安装 java -version javac -versionIntelliJ IDEA社区版或旗舰版社区版免费基础功能完整旗舰版提供 Spring 初始化和数据库工具Maven 3.6# 验证安装 mvn -vMySQL 8.0安装 MySQL 服务器配置 root 密码创建测试数据库环境变量配置JAVA_HOME 指向 JDK 安装目录MAVEN_HOME 指向 Maven 安装目录PATH 包含 %JAVA_HOME%\bin 和 %MAVEN_HOME%\bin4. 创建第一个 SpringBoot 项目我们使用 Spring Initializr 快速生成项目骨架。通过 IDEA 创建打开 IDEA → New Project → Spring Initializr选择项目信息Project: MavenLanguage: JavaSpring Boot: 3.2.0推荐Group: com.exampleArtifact: demoPackage: com.example.demo选择依赖Spring WebWeb 功能Spring Boot DevTools热部署Lombok简化代码生成项目并导入 IDEA项目结构说明demo/ ├── src/ │ ├── main/ │ │ ├── java/com/example/demo/ │ │ │ ├── DemoApplication.java # 主启动类 │ │ │ └── controller/ # 控制器层 │ │ └── resources/ │ │ ├── application.properties # 配置文件 │ │ └── static/ # 静态资源 │ └── test/ # 测试代码 ├── pom.xml # Maven 配置 └── target/ # 编译输出验证项目启动找到DemoApplication.java右键运行package com.example.demo; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }启动成功后控制台显示Tomcat started on port(s): 8080 (http) Started DemoApplication in 2.345 seconds访问 http://localhost:8080 应该看到 Whitelabel Error Page正常尚未定义首页。5. 基础功能开发与测试5.1 创建第一个 REST 接口在controller包下创建HelloController.javapackage com.example.demo.controller; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestParam; import org.springframework.web.bind.annotation.RestController; RestController public class HelloController { GetMapping(/hello) public String hello(RequestParam(value name, defaultValue World) String name) { return String.format(Hello %s!, name); } GetMapping(/api/info) public ApiResponse getInfo() { return new ApiResponse(OK, SpringBoot 服务运行正常); } // 内部响应类 public static class ApiResponse { private String status; private String message; public ApiResponse(String status, String message) { this.status status; this.message message; } // getter/setter 省略实际使用 Lombok Data } }接口测试启动服务后测试# 测试基础接口 curl http://localhost:8080/hello curl http://localhost:8080/hello?nameSpringBoot # 测试 JSON 接口 curl http://localhost:8080/api/info5.2 配置 application.properties在resources/application.properties中添加配置# 服务器配置 server.port8080 server.servlet.context-path/demo # 应用配置 spring.application.namedemo-app # 日志配置 logging.level.com.example.demoDEBUG logging.pattern.console%d{yyyy-MM-dd HH:mm:ss} - %msg%n # 开发配置 spring.devtools.restart.enabledtrue spring.mvc.log-request-detailstrue重启服务现在访问地址变为http://localhost:8080/demo/hello5.3 热部署测试修改HelloController的返回信息保存后观察控制台Restarting application... Started DemoApplication in 1.234 seconds无需手动重启修改立即生效。6. 数据库整合与 MyBatis 实战6.1 数据库准备在 MySQL 中执行CREATE DATABASE springboot_demo; USE springboot_demo; CREATE TABLE users ( id BIGINT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(50) NOT NULL UNIQUE, email VARCHAR(100) NOT NULL, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); INSERT INTO users (username, email) VALUES (testuser, testexample.com), (admin, adminexample.com);6.2 添加数据库依赖在pom.xml中添加dependencies !-- 已有依赖 -- dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency !-- 新增数据库相关 -- dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version /dependency dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.projectlombok/groupId artifactIdlombok/artifactId optionaltrue/optional /dependency /dependencies6.3 配置数据源application.properties新增# 数据库配置 spring.datasource.urljdbc:mysql://localhost:3306/springboot_demo spring.datasource.usernameroot spring.datasource.passwordyour_password spring.datasource.driver-class-namecom.mysql.cj.jdbc.Driver # MyBatis 配置 mybatis.mapper-locationsclasspath:mapper/*.xml mybatis.type-aliases-packagecom.example.demo.entity6.4 创建实体类和 Mapper创建实体类User.javapackage com.example.demo.entity; import lombok.Data; import java.time.LocalDateTime; Data public class User { private Long id; private String username; private String email; private LocalDateTime createdAt; }创建 Mapper 接口UserMapper.javapackage com.example.demo.mapper; import com.example.demo.entity.User; import org.apache.ibatis.annotations.*; import java.util.List; Mapper public interface UserMapper { Select(SELECT * FROM users) ListUser findAll(); Select(SELECT * FROM users WHERE id #{id}) User findById(Long id); Insert(INSERT INTO users(username, email) VALUES(#{username}, #{email})) Options(useGeneratedKeys true, keyProperty id) int insert(User user); Update(UPDATE users SET username#{username}, email#{email} WHERE id#{id}) int update(User user); Delete(DELETE FROM users WHERE id#{id}) int delete(Long id); }6.5 创建用户服务接口创建UserController.javapackage com.example.demo.controller; import com.example.demo.entity.User; import com.example.demo.mapper.UserMapper; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.*; import java.util.List; RestController RequestMapping(/api/users) public class UserController { Autowired private UserMapper userMapper; GetMapping public ListUser getAllUsers() { return userMapper.findAll(); } GetMapping(/{id}) public User getUserById(PathVariable Long id) { return userMapper.findById(id); } PostMapping public String createUser(RequestBody User user) { userMapper.insert(user); return 用户创建成功; } PutMapping(/{id}) public String updateUser(PathVariable Long id, RequestBody User user) { user.setId(id); userMapper.update(user); return 用户更新成功; } DeleteMapping(/{id}) public String deleteUser(PathVariable Long id) { userMapper.delete(id); return 用户删除成功; } }6.6 数据库接口测试使用 curl 或 Postman 测试# 查询所有用户 curl http://localhost:8080/demo/api/users # 根据ID查询用户 curl http://localhost:8080/demo/api/users/1 # 创建新用户 curl -X POST http://localhost:8080/demo/api/users \ -H Content-Type: application/json \ -d {username:newuser,email:newexample.com} # 更新用户 curl -X PUT http://localhost:8080/demo/api/users/1 \ -H Content-Type: application/json \ -d {username:updated,email:updatedexample.com} # 删除用户 curl -X DELETE http://localhost:8080/demo/api/users/37. 微服务架构核心概念理解7.1 什么是微服务架构微服务架构是将单一应用程序划分成一组小服务的开发方法每个服务运行在自己的进程中服务之间通过轻量级机制通常是 HTTP API通信。SpringBoot 在微服务中的角色每个微服务是一个独立的 SpringBoot 应用提供内嵌服务器无需外部 Tomcat自动配置简化服务开发与 Spring Cloud 生态无缝集成7.2 微服务核心组件组件作用SpringBoot 整合服务注册发现服务动态注册和发现Eureka、Consul配置中心统一管理配置Spring Cloud ConfigAPI 网关统一入口、路由、过滤Spring Cloud Gateway负载均衡请求分发Ribbon、LoadBalancer熔断器服务降级、容错Hystrix、Resilience4j7.3 简单微服务示例创建两个独立的 SpringBoot 项目用户服务 (user-service)RestController RequestMapping(/users) public class UserController { GetMapping(/{id}) public User getUser(PathVariable Long id) { // 查询用户信息 return userService.findById(id); } }订单服务 (order-service)RestController RequestMapping(/orders) public class OrderController { Autowired private RestTemplate restTemplate; GetMapping(/user/{userId}) public ListOrder getOrdersByUser(PathVariable Long userId) { // 调用用户服务获取用户信息 User user restTemplate.getForObject( http://user-service/users/{userId}, User.class, userId ); // 查询用户订单 return orderService.findByUser(user); } }8. 生产环境配置与优化8.1 多环境配置创建不同的配置文件application-dev.properties开发环境application-test.properties测试环境application-prod.properties生产环境通过启动参数指定环境java -jar demo.jar --spring.profiles.activeprod8.2 健康检查与监控SpringBoot Actuator 提供生产就绪功能在pom.xml添加dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-actuator/artifactId /dependency配置application.properties# Actuator 配置 management.endpoints.web.exposure.includehealth,info,metrics management.endpoint.health.show-detailsalways # 自定义健康检查 management.health.diskspace.enabledtrue访问监控端点http://localhost:8080/demo/actuator/healthhttp://localhost:8080/demo/actuator/infohttp://localhost:8080/demo/actuator/metrics8.3 日志配置优化生产环境日志配置# 日志文件输出 logging.file.nameapp.log logging.pattern.file%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n # 按大小滚动日志 logging.logback.rollingpolicy.max-file-size10MB logging.logback.rollingpolicy.max-history30 # 不同包的不同日志级别 logging.level.com.example.demoINFO logging.level.org.springframework.webWARN9. 常见问题与排查方法问题现象可能原因排查方式解决方案启动时报端口占用8080 端口被其他进程占用netstat -ano | findstr 8080修改 server.port 或终止占用进程数据库连接失败密码错误、网络不通、服务未启动检查 MySQL 服务状态和连接字符串验证配置确保数据库可访问依赖下载失败Maven 仓库网络问题检查 Maven settings.xml配置国内镜像源热部署不生效DevTools 配置问题检查 IDEA 自动编译设置File → Settings → Build → Compiler → Build project automatically404 错误路径错误或控制器未扫描检查 SpringBootApplication 扫描范围确保控制器在主类同级或子包静态资源访问不到资源路径配置错误检查 static 目录位置资源应放在 src/main/resources/staticMyBatis 映射失败配置路径错误或注解问题检查 mapper-locations 和 Mapper确保 XML 文件在正确路径9.1 内存溢出处理常见错误java.lang.OutOfMemoryError: Java heap space解决方案增加 JVM 内存参数java -Xms512m -Xmx1024m -jar demo.jar分析内存使用# 查看内存状态 jstat -gc pid 1000使用 VisualVM 或 JProfiler 分析内存泄漏9.2 性能优化建议连接池配置# HikariCP 连接池配置 spring.datasource.hikari.maximum-pool-size20 spring.datasource.hikari.minimum-idle5 spring.datasource.hikari.idle-timeout300000JSON 序列化优化Configuration public class WebConfig { Bean public MappingJackson2HttpMessageConverter mappingJackson2HttpMessageConverter() { ObjectMapper mapper new ObjectMapper(); mapper.configure(SerializationFeature.FAIL_ON_EMPTY_BEANS, false); return new MappingJackson2HttpMessageConverter(mapper); } }静态资源缓存# 缓存静态资源 spring.web.resources.cache.cachecontrol.max-age3600 spring.web.resources.cache.cachecontrol.publictrue10. 学习路线与进阶方向10.1 SpringBoot 深入学习路径基础掌握本文覆盖项目创建和启动REST API 开发数据库整合基础配置中级进阶安全控制Spring Security缓存技术Redis消息队列RabbitMQ任务调度Scheduled高级应用微服务架构Spring Cloud分布式事务容器化部署Docker性能监控和调优10.2 面试重点准备常见面试题方向SpringBoot 自动配置原理Starter 的作用和实现机制内嵌容器的优势和原理如何自定义 StarterSpringBoot 与 Spring MVC 的关系配置文件加载优先级条件注解的使用场景实战问题如何设计一个完整的 RESTful API数据库事务如何管理如何进行单元测试和集成测试如何部署到生产环境10.3 项目实战建议从简单项目开始个人博客系统待办事项应用简单的 CRM 系统逐步添加复杂度添加用户认证和授权集成第三方 API实现文件上传下载添加缓存和搜索功能生产级考虑错误处理和日志记录性能监控和健康检查安全防护和 SQL 注入预防数据库迁移和版本控制这套 SpringBoot 教程的核心价值在于实战导向通过实际代码演示让学习者快速理解框架的核心概念。建议按照文章步骤实际操作遇到问题时参考排查方法逐步积累开发经验。SpringBoot 作为现代 Java 开发的事实标准掌握其核心用法对职业发展至关重要。下一步可以深入 Spring Cloud 微服务生态或者学习前端框架实现全栈开发能力。