Spring Boot 入门教程：60分钟快速上手

引言：第一次接触Spring Boot的忐忑心情

还记得刚进公司的时候，我被分配到一个后端开发项目组。项目是用 Spring Boot 搭建的微服务架构，作为新人，第一次看到那么多注解、自动配置和各种starter依赖，我内心其实有点发虚。

说实话，我当时觉得 Spring Boot 像个“黑盒子”，写出来的代码看起来挺简洁的，但一旦出问题就不知道怎么下手了。比如最简单的 REST 接口写出来返回值为空，调试半天才发现忘记加 @RestController 注解了；还有数据库操作时用了 JPA，结果查询慢得不行，同事说是因为没有正确设置懒加载。

所以，今天我想以一个初学者的身份，结合我在项目中遇到的真实问题，来写一篇关于如何在 60 分钟内快速上手 Spring Boot 的入门教程。不是那种“hello world”级别的 Demo 教程，而是真正贴近实际开发工作的一套实践指南。

---

项目背景：我们为什么要用Spring Boot？

我们团队当时正在开发一个商品推荐系统的后台模块，需要支持用户行为数据采集、个性化推荐计算以及商品信息同步等功能。

技术选型上，我们选择了 Spring Boot，主要基于以下几点原因：

1. 开发效率高：Spring Boot 内置了很多 Starter 依赖，省去了大量 XML 配置；
2. 生态成熟：Spring Cloud 与 Spring Security 等框架无缝集成；
3. 微服务友好：天然支持构建独立运行的服务；
4. 社区活跃：出了问题查资料非常方便。

不过，对于新手来说，刚开始还是会因为不了解其设计哲学而踩不少坑。

---

第一小时实战演练：从新建项目到运行第一个接口

步骤一：创建工程（5分钟）

我们通过 start.spring.io 创建了一个基础项目：

• Group ID: com.example
• Artifact ID: demoshop-api
• Dependencies:
  • Spring Web
  • Spring Data JPA
  • MySQL Driver
  • Lombok
  • Spring Boot DevTools

生成后导入 IDE（IntelliJ IDEA 或 VSCode 都可以），结构如下：

src
├── main
│   ├── java
│   │   └── com.example.demoshopapi
│   │       ├── DemoshopApiApplication.java
│   │       └── controller
│   │           └── ProductController.java
│   │       └── model
│   │           └── Product.java
│   │       └── repository
│   │           └── ProductRepository.java
│   └── resources
│       ├── application.properties
│       └── data.sql

💡 提示：Lombok 可以大大简化 Java Bean 的编写，建议务必加上。但在某些老版本 IDEA 中可能需要手动安装插件。

---

步骤二：配置数据库连接（10分钟）

在 application.properties 文件中添加数据库连接信息：

spring.datasource.url=jdbc:mysql://localhost:3306/shopdb?useSSL=false&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=your_password

spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

刚开始我忽略了 ddl-auto=update 这个参数，导致程序启动时报错找不到表。后来才知道 Spring Boot 默认不会自动建表，除非你指定了这个策略。

另外，在开发环境开启 show-sql 是很有帮助的，可以看到 Hibernate 实际执行的 SQL，便于排查问题。

---

步骤三：定义数据模型和 Repository（15分钟）

接下来是定义实体类和对应的 JPA 接口。

Product.java

@Entity
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Product {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;
    private BigDecimal price;
}

ProductRepository.java

public interface ProductRepository extends JpaRepository<Product, Long> {}

这里要特别注意一点：我之前误以为 JPA 的查询性能一定很好，结果上线之后发现某个分页接口响应时间达到了 800ms。后来优化了一下 SQL 查询方式，才降到了 100ms 左右。

🚨 注意事项：

• 初期别太依赖默认的 JPA 方法，尤其是复杂的查询逻辑。
• 对于高频查询的接口，建议自定义 SQL 或者使用 QueryDSL 来提高可读性和效率。

---

步骤四：编写 Controller 接口（10分钟）

现在我们来写第一个 REST API：

ProductController.java

@RestController
@RequestMapping("/products")
public class ProductController {

    @Autowired
    private ProductRepository productRepository;

    @GetMapping("")
    public List<Product> getAllProducts() {
        return productRepository.findAll();
    }

    @PostMapping("")
    public Product createProduct(@RequestBody Product product) {
        return productRepository.save(product);
    }
}

这个时候如果你运行 DemoshopApiApplication.java 启动类，访问 http://localhost:8080/products 就能看到接口返回的数据了！

但我记得第一次测试时却得到了空数组。折腾半天发现是数据库里没数据，赶紧写了 data.sql 文件放在 resources 目录下让它初始化数据：

INSERT INTO product (name, price) VALUES ('手机', 2999.00);
INSERT INTO product (name, price) VALUES ('耳机', 199.00);

Spring Boot 会在每次启动时自动执行它。

---

步骤五：日志与热重载（10分钟）

开发阶段，推荐启用 DevTools 和日志输出：

<!-- pom.xml -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <scope>runtime</scope>
    <optional>true</optional>
</dependency>

然后配置 application.properties：

spring.devtools.restart.enabled=true
logging.level.root=INFO
logging.level.com.example.demoshopapi=DEBUG

这样修改完代码不需要重启应用，自动生效，并且能看清楚每个方法调用了哪些SQL语句，对调试帮助非常大。

---

最后一步：部署上线前的小调整（10分钟）

当我们准备把服务部署到生产环境的时候，有几个点需要注意：

1. 关闭 DevTools：只保留 compile scope，避免热部署暴露安全隐患；
2. 切换为正式数据库：MySQL 8.x 性能更好，同时支持 JSON 类型字段；
3. 启用 Actuator 监控：用来检查服务健康状态和内存占用；
4. 日志级别调整为 INFO 或 WARN：避免 DEBUG 日志刷屏影响性能；
5. 考虑异步处理：复杂业务尽量用消息队列或线程池处理，不要阻塞主线程；
6. 做好异常统一处理：写一个 @ControllerAdvice 来拦截所有未捕获的异常。

这些内容后面都可以慢慢拓展，但初期搭建的时候，心里要有数，不能等上线出事了才去补。

---

我们遇到的挑战：那些年我们一起踩过的坑

遇到的问题 1：接口响应慢？

我们在压测过程中发现，一个商品列表接口平均耗时 700ms。一开始以为是网络问题，但排查下来发现是 JPA 自动生成的 SQL 不够高效。

解决方案是将默认的 findAll() 改成了原生 SQL 查询，并加上索引，最终降到 150ms。

@Query("SELECT p FROM Product p WHERE p.price > :minPrice")
List<Product> findByMinPrice(@Param("minPrice") BigDecimal minPrice);

遇到的问题 2：本地跑得好好的，线上出问题？

我们本地使用 H2 内存数据库做测试，上线却换成 MySQL，有些 SQL 在语法上不兼容。例如 LIMIT 和 OFFSET 在 MySQL 上没问题，但在 Oracle 上就不能这么用了。

教训是：本地开发尽量使用跟线上一致的数据库类型。实在不行也建议尽早接入预发布环境进行联调测试。

遇到的问题 3：多模块管理混乱？

随着功能越来越多，我们试图拆分成多个模块，但 Spring Boot 默认是单 Module 构建，多模块需要手动配置父子 pom。

建议：如果项目规模不大，尽量保持单一模块。否则一定要规范子模块之间的依赖关系，避免循环引用。

---

效果总结：为什么选择Spring Boot？

整个项目从零开始，我们只用了不到两天时间就把基础骨架搭好了。这在过去用传统 Spring MVC + MyBatis 的组合至少需要一周以上的时间。

更重要的是，Spring Boot 帮我们规避了不少低级错误，让开发者可以把精力集中在业务逻辑实现上，而不是繁琐的配置项和框架整合上。

目前这套服务稳定运行了几个月，QPS 达到了 200+，没有出现重大故障。虽然中间也遇到一些性能瓶颈和小 bug，但整体而言是值得推荐的技术栈。

---

给新手的几条经验分享

如果你是刚开始学 Spring Boot 的新手，以下是我在真实项目中的几点经验和建议，希望能帮到你少走弯路：

✅ 1. 把官方文档当教材来读

Spring Boot 官方文档 写得很细致，尤其“Getting Started”章节，是学习的最佳起点。

我曾为了搞明白 Spring Boot 自动装配的原理，翻了好几天文档，终于明白了什么是条件化装配、什么是 starters、什么是 spring.factories 文件。

✅ 2. 多模仿优秀开源项目的结构

GitHub 上有很多 Spring Boot 的 starter kit，你可以参考他们的项目结构、配置方式，甚至命名规范。

比如 spring-petclinic 虽然是个小项目，但结构清晰，非常适合初学者学习。

✅ 3. 开发中要重视接口设计和数据库建模

虽然 Spring Boot 让你轻松写出 REST 接口，但设计一个合理的接口并不简单。比如：

• 是否应该采用 RESTful 风格？
• GET/POST/PUT/DELETE 是否区分明确？
• 返回值是否统一封装？（建议封装成通用 Result 对象）
• 数据库字段命名是否一致？有没有合适的索引？

这些问题如果不提前规划好，后期改起来成本很高。

✅ 4. 日常调试多用 Actuator 和日志

Spring Boot 提供了 /actuator/health、/actuator/metrics 等接口，配合 Prometheus 或 Grafana 很容易做监控。

同时，强烈建议使用 Logback 替换默认的日志系统，支持按文件大小滚动、按日期归档等功能，适合生产环境。

---

结语：从Spring Boot起步，向更广阔的世界出发

这篇文章记录了我当初初入职场时学习 Spring Boot 的过程，也是我成长的一个缩影。虽然只是一个小小的入门教程，但它包含了我在真实项目中踩过坑、解决问题的经验，而不是纸上谈兵的理论。

希望这篇“接地气”的 Spring Boot 实战入门文章，能给还在门外张望的新人们一些信心和方向。记住一句话：优秀的程序员从来不是靠看完文档学会的，而是靠一个个 bug 调试出来的。

最后送大家一句我特别喜欢的话：

"The best way to learn is to build something real."
—— Josh Long（Spring Advocate）

祝你在 Spring Boot 的道路上越走越顺！