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

引言：从零开始的后端开发之旅

我第一次接触 Spring Boot 是在五年前刚入行做后端开发的时候。那时候刚从传统的 Java Web 项目（比如用 Tomcat + XML 配置 + Servlet）转过来，面对繁杂的配置和冗长的开发流程，真是感觉力不从心。

直到有一天，我在公司接到一个紧急需求：要在一天内搭建一个简单的用户管理系统，用来支撑我们前端临时上线的一个运营活动页面。当时时间紧迫，领导还特别强调“不能拖前端后腿”。我就想，如果还是按照之前那套老办法去搭框架、配 Bean、写 DAO，估计一天都搭不完。

就在这个时候，同事推荐我尝试一下 Spring Boot，说它是现代 Java 后端开发的利器，能帮你 快速搭建出完整的应用骨架，而且功能完整、结构清晰。

那一次是我真正开始接触 Spring Boot 的起点。虽然最后没能完全在一天之内完成所有业务逻辑，但确实只用了不到两小时就把整个项目结构搭好了，并且接口也跑通了。

今天写这篇文章，我想结合那次真实的经历，带你一起体验一下如何在 60 分钟内快速上手 Spring Boot，并构建一个可以运行的小型后端服务。

---

场景背景：为什么是 Spring Boot？

我们先还原一下当时的项目场景。

项目背景是一个面向用户的抽奖系统，要求如下：

• 提供基础的用户注册与登录功能；
• 支持创建抽奖活动；
• 用户可以参与抽奖；
• 数据需要存储到 MySQL；
• 前端需要调用 API 接口进行渲染和操作；
• 必须保证基本的安全性（如密码加密、权限验证）；
• 要有一定的扩展性，方便后续加新功能。

这种类型的需求在创业团队或中小型项目中非常常见。传统方式需要写大量的 web.xml、spring-config.xml 和 mvc-config.xml，还要自己管理依赖版本、Tomcat 配置、数据库连接池等等。

而 Spring Boot 则通过 自动装配机制（Auto Configuration）、起步依赖（Starter Dependencies） 等特性，极大降低了这些成本。

---

遇到的问题与挑战：如何快速构建可交付的服务？

说实话，那次任务对我个人最大的挑战不是业务逻辑本身，而是 如何在最短的时间内把框架搭起来，并保证代码质量、结构合理、符合规范。

我们经常遇到的情况是：

• 框架搭建太慢，耽误整体进度；
• 各层结构混乱，后续维护困难；
• 安全模块缺失，容易引发安全漏洞；
• 接口设计不合理，导致前后端协同低效；
• 缺乏良好的日志体系，线上排查困难。

这些问题都需要在搭建阶段就考虑进去。否则后期调整起来代价很大。

所以这次的任务目标是：

用最快的速度搭建一个具有基础功能的后端服务，具备合理的结构、可用的接口、一定的安全性，并为后续开发留出良好的扩展空间。

---

技术选型与实现思路：Spring Boot 快速启动的关键点

核心选型：

• Spring Boot 2.7.x
• Java 11
• MyBatis Plus（ORM）
• Lombok（简化实体类编写）
• Redis（缓存热点数据）
• MySQL 8.x
• Spring Security + JWT（安全控制）

整体架构设计：

Controller -> Service -> Mapper <-> DB

典型的 MVC 架构，加上一层缓存。

为了便于快速开发，我们使用 Spring Initializr 来生成初始项目模板，再手动引入所需的组件。

---

代码实践：一步一步搭建 Spring Boot 项目

第一步：初始化项目结构

可以通过 https://start.spring.io 页面快速生成 Spring Boot 项目脚手架。

勾选以下依赖项：

• Spring Web（Web 开发核心）
• Spring Data JPA（也可用，但我们这里用 MyBatis Plus）
• Spring Security（权限控制）
• MyBatis Framework（如果没找到可以直接手动添加）
• Lombok（简化代码）
• MySQL Driver

下载项目解压后导入 IDE（IDEA 或 Eclipse），即可看到一个典型的 Spring Boot 项目结构。

第二步：配置数据库连接

在 application.yml 中添加：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/lottery_system?useSSL=false&serverTimezone=UTC&characterEncoding=UTF-8
    username: root
    password: your_password
    driver-class-name: com.mysql.cj.jdbc.Driver


![服务器部署方案-1](https://code-guide.oss.shanghai.autogptai.club/common/file/download?name=date2025062719/3f6ebf19-c426-43b0-a0ed-0f9636200651.jpg)


mybatis-plus:
  mapper-locations: classpath:mapper/*.xml
  configuration:
    mapUnderscoreToCamelCase: true

第三步：定义实体类与 Mapper

使用 Lombok 注解简化实体类定义：

import lombok.Data;

@Data
public class User {
    private Long id;
    private String username;
    private String password;
    private String email;
    private LocalDateTime createdAt;
}

定义 MyBatis Plus Mapper：

public interface UserMapper extends BaseMapper<User> {}

第四步：编写 Controller 层逻辑

定义 RESTful 接口：

@RestController
@RequestMapping("/api/users")
public class UserController {

    @Autowired
    UserService userService;

    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getUserById(id);
    }

    @PostMapping
    public User createUser(@RequestBody User user) {
        return userService.createUser(user);
    }
}

第五步：加入安全认证（JWT）

集成 Spring Security 与 JWT Token 实现简单的登录鉴权流程。

定义登录接口：

@PostMapping("/login")
public String login(@RequestBody LoginRequest request) {
    // 登录逻辑，返回 JWT token
    return jwtUtil.generateToken(username);
}

并在拦截器中校验 Token：

@Override
protected void doFilterInternal(HttpServletRequest request, 
                                HttpServletResponse response, 
                                FilterChain filterChain)
        throws ServletException, IOException {
    String token = getTokenFromRequest(request);
    if (token != null && jwtUtil.validateToken(token)) {
        String username = jwtUtil.getUsernameFromToken(token);
        UsernamePasswordAuthenticationToken authentication = new UsernamePasswordAuthenticationToken(username, null, new ArrayList<>());
        SecurityContextHolder.getContext().setAuthentication(authentication);
    }
    filterChain.doFilter(request, response);
}

这样我们就实现了一个具备基础结构、数据库访问、接口定义、安全控制的后端服务框架。

---

踩坑经验分享：那些年我踩过的坑

在第一次使用 Spring Boot 的过程中，我也踩了不少坑，以下是一些典型问题及解决方案：

1. 数据库连接失败

刚开始怎么都连不上 MySQL，报错 Driver not found，后来发现是驱动版本不对，换成 com.mysql.cj.jdbc.Driver 就好了。

建议：使用最新的 MySQL Connector/J 驱动，并在 URL 中加上 serverTimezone=UTC 防止时区问题。

2. 自动注入失败

有些时候 Service 层没有加上 @Service，或者在测试类里直接 new 对象，导致依赖注入失败。

解决方法：统一使用 @Autowire 自动注入，并确保组件被正确扫描。

3. 接口跨域问题

前后端分离之后，出现了跨域访问限制。

解决方案：在配置类中加上：

@Configuration
@EnableWebMvc
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**").allowedOrigins("*");
    }
}

4. 日志输出混乱

一开始不知道怎么配置日志输出级别，导致控制台信息太多看不清关键内容。

推荐使用 Logback 或者 Spring Boot 默认的日志框架，在 application.yml 中设置：

logging:
  level:
    com.example.lottery.mapper: debug

这样就可以单独查看某个包下的 SQL 打印。

---

最终效果与收获：60分钟快速搭建一个可用的服务

那次任务最终我在 2 小时内完成了服务的基础搭建，并在半天内写完了主要接口和单元测试。虽然没有完全做完所有的业务逻辑，但已经能够让前端同学提前接入接口调试。

这让我意识到：

• Spring Boot 极大地提升了开发效率；
• 模块化的结构有助于后期维护；
• 合理的设计可以节省大量重构成本。

更关键的是，它帮助我在团队中树立了“能打硬仗”的形象，也为后续深入学习微服务、Spring Cloud 打下了坚实的基础。

---

经验总结与建议

如果你是刚入门的 Java 后端开发者，我强烈建议你尽早掌握 Spring Boot。它不仅是企业级项目的标配，更是你简历中加分的利器。

下面是我给新手的一些建议：

✅ 推荐学习路径：

1. 先熟悉 Spring Core 和 Spring MVC 的基本原理；
2. 学会用 Maven / Gradle 管理依赖；
3. 动手写几个小项目（CRUD 类型）练手；
4. 了解自动装配机制和常用 Starter 包的作用；
5. 学习如何配置外部属性文件（application.yml）；
6. 掌握日志、事务、异常处理等基础功能；
7. 后续再深入研究 Spring Boot + Spring Cloud 生态。

🧠 几个实用技巧：

• 多使用 Lombok，减少 boilerplate code；
• 用 Postman 或 Apifox 测试接口；
• 使用 Actuator 监控健康状态；
• 搭建本地 DevOps 环境，学习部署打包命令（如 mvn package）；
• 集成 Swagger 文档生成 API 说明文档；
• 写单元测试，提升代码质量；
• 学会在生产环境排查问题，比如 GC、OOM、慢查询等。

---

结语：编程的本质是解决问题

回过头来看，那次任务教会我的远远不止是 Spring Boot 的使用技巧。

更重要的是，我学会了：

• 如何根据项目需求快速搭建可用系统；
• 怎么做出技术选型的判断；
• 面对紧急任务保持冷静的心态；
• 在实践中不断优化架构设计；
• 以及，永远不要怕尝试新技术。

技术一直在变，但解决问题的核心能力永远不会过时。

希望这篇真实分享能对你有所帮助，也希望你能尽快掌握 Spring Boot，并用它构建出属于自己的第一个完整项目。

加油，下一个优秀的后端工程师可能就是你！ 🚀

---

📌 附录：文中提到的 GitHub 示例地址（示例）
https://github.com/example/springboot-lottery-demo （仅作演示参考，请替换为实际项目地址）