Spring Boot 入门教程：60分钟快速上手，我的实战踩坑之路

勇敢狼

2025-06-27 11:20

阅读 582

开篇：为什么是Spring Boot？

作为一名后端开发工程师，这些年我参与过不少Java项目的架构与实现。从传统的Spring MVC到现在的微服务架构，Spring生态一直在演进，而Spring Boot无疑是目前最火、也是最容易上手的框架之一。

记得2019年刚入职一家中型互联网公司时，我们还在用传统方式搭建后台系统，大量的配置文件、复杂的XML结构，甚至每个新模块都要手动集成各种依赖和组件。那会儿每次新建项目，我都得花半天时间配置依赖和基础环境，效率低不说，还特别容易出错。

后来接触到Spring Boot之后，那种“开箱即用”的体验简直让我感动——你只需要告诉它你要什么，它就会帮你准备好一切。于是我们团队逐步开始转向Spring Boot，构建新的微服务模块、重构老系统、甚至做内部工具平台，都能快速落地。可以说，它是我在实际工作中最常用来打“开局第一枪”的利器。

今天我想结合自己的亲身经历，带大家在60分钟内快速掌握Spring Boot入门级开发流程。我会用一个真实的小场景来演示如何从零搭建一个Web接口服务，并分享我在实践中遇到的一些典型问题和解决方法。

项目背景：一个典型的CRUD需求

为了更贴近实际情况，我们假设一个常见的业务需求：公司需要搭建一个用户信息管理的API接口，支持查询、新增、更新、删除等基本操作。

这是一个标准的CRUD场景，非常适合用Spring Boot来快速实现。我们的目标很明确：

搭建一个基于Spring Boot的Web应用
使用JPA连接MySQL数据库
实现RESTful风格的接口
配置日志、异常处理和跨域支持（CORS）
在本地运行并测试功能

整个过程控制在1小时左右完成，不夸张吧？

技术选型与前期准备

数据库设计模型-1

技术选型与前期准备

先说说我会用到的技术栈：

Java 17（现在主流版本，性能提升明显）
Spring Boot 3.x（兼容性更好，内置Tomcat）
MySQL 8.0
IntelliJ IDEA（个人习惯，Eclipse或VSCode也都可以）
Maven（项目管理和依赖管理）

在开始之前，请确保你已经安装了以下工具：

JDK 17 或以上版本
数据库管理系统（如MySQL）
IDE（推荐IntelliJ IDEA社区版即可）
Maven（用于依赖管理）

如果你还没准备好，可以花几分钟设置一下环境。这一步非常关键，后面很多坑都可能是因为环境没配置好导致的。

第一步：创建Spring Boot项目

1. 使用Spring Initializr生成项目骨架

Spring官方提供了Spring Initializr这个在线工具，我们可以直接用它来生成初始项目模板。

填入以下信息：

Project: Maven
Language: Java
Spring Boot Version: 3.2.x
Group: com.example
Artifact: demo
Name: DemoApplication
Packaging: Jar
Java: 17

选择如下依赖项：

Spring Web（Web开发必备）
Spring Data JPA（ORM框架）
MySQL Driver（数据库驱动）
Lombok（简化POJO代码）
Spring Boot DevTools（热部署）

点击“Generate”按钮下载压缩包，解压后导入IDEA即可。

2. 导入项目到IDEA

解压后你会看到标准的Maven项目结构。使用IDEA打开该项目，等待Maven自动下载相关依赖。首次打开可能会卡一会儿，耐心等下（网络慢的话可能需要5分钟左右）。

第二步：配置数据库连接

接下来我们需要让Spring Boot连接到MySQL数据库。这一步非常重要，因为后面我们要用到JPA来进行数据持久化。

1. 修改application.properties

Spring Boot默认使用src/main/resources/application.properties来配置全局参数。将其内容替换为如下配置（根据你的MySQL配置调整用户名、密码、URL）：

spring.datasource.url=jdbc:mysql://localhost:3306/demo_db?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.dialect=org.hibernate.dialect.MySQL8Dialect

小贴士：这里的ddl-auto=update表示Spring Boot会自动根据实体类更新表结构，适用于开发阶段。生产环境不建议这么干，容易搞乱表结构。

2. 创建数据库demo_db

提前在MySQL里创建一个名为demo_db的数据库，否则启动时会报错：

CREATE DATABASE demo_db;

第三步：定义实体类和Repository接口

接下来我们创建一个简单的用户模型，并通过JPA来管理数据库交互。

1. 定义User实体类

在com.example.demo.model包下创建一个User.java类：

package com.example.demo.model;

import jakarta.persistence.*;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@AllArgsConstructor
@Entity
@Table(name = "users")
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    
    @Column(nullable = false, length = 50)
    private String name;
    
    @Column(unique = true, nullable = false)
    private String email;
}

Lombok的@Data注解自动生成getter/setter/toString等方法，省去样板代码。

2. 创建UserRepository接口

在com.example.demo.repository包下创建接口：

package com.example.demo.repository;

import com.example.demo.model.User;
import org.springframework.data.jpa.repository.JpaRepository;

public interface UserRepository extends JpaRepository<User, Long> {
}

JpaRepository自带常见的CRUD方法，比如save、findById、findAll、deleteById等。

第四步：编写Controller层接口

接下来是最核心的部分——写接口！

我们新建一个UserController类，路径为/api/users，支持GET、POST、PUT、DELETE等常见请求方式。

package com.example.demo.controller;

import com.example.demo.model.User;
import com.example.demo.repository.UserRepository;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.*;

import java.util.List;

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

    @Autowired
    private UserRepository userRepository;

    @GetMapping
    public List<User> getAllUsers() {
        return userRepository.findAll();
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public User createUser(@RequestBody User user) {
        return userRepository.save(user);
    }

    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userRepository.findById(id).orElseThrow(() -> new RuntimeException("User not found"));
    }

    @PutMapping("/{id}")
    public User updateUser(@PathVariable Long id, @RequestBody User userDetails) {
        User user = userRepository.findById(id).orElseThrow(() -> new RuntimeException("User not found"));
        user.setName(userDetails.getName());
        user.setEmail(userDetails.getEmail());
        return userRepository.save(user);
    }

    @DeleteMapping("/{id}")
    public void deleteUser(@PathVariable Long id) {
        userRepository.deleteById(id);
    }
}

这段代码实现了一个完整的用户管理接口，支持：

GET /api/users → 获取所有用户
POST /api/users → 创建用户
GET /api/users/{id} → 根据ID查询用户
PUT /api/users/{id} → 更新用户
DELETE /api/users/{id} → 删除用户

第五步：处理异常与日志输出

虽然上面的代码已经能跑起来了，但在实际项目中，我们还需要加入一些健壮性设计，例如统一异常处理和日志输出。

1. 使用@ControllerAdvice统一处理异常

在com.example.demo.exception包下创建GlobalExceptionHandler类：

package com.example.demo.exception;

import org.springframework.http.HttpStatus;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.ResponseStatus;
import org.springframework.web.bind.annotation.RestControllerAdvice;

import java.util.HashMap;
import java.util.Map;

@RestControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(RuntimeException.class)
    @ResponseStatus(value = HttpStatus.NOT_FOUND)
    public Map<String, String> handleResourceNotFoundException(RuntimeException ex) {
        Map<String, String> errorMap = new HashMap<>();
        errorMap.put("error", ex.getMessage());
        return errorMap;
    }
}

这样，当访问不存在的用户ID时，就不会直接抛出500错误，而是返回友好的JSON格式。

2. 添加日志输出

Spring Boot默认集成了SLF4J + Logback的日志框架，我们只需要引入logback-spring.xml进行配置即可。

在resources目录下新建logback-spring.xml：

<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <root level="INFO">
        <appender-ref ref="STDOUT"/>
    </root>
</configuration>

然后就可以在代码中使用LoggerFactory来输出日志了。

第六步：开启跨域支持（CORS）

在浏览器发起的HTTP请求中，默认是不允许跨域的。如果你前端项目部署在别的端口（比如React前端运行在3000），而后端跑在8080，那么不做跨域处理的话前端就访问不到接口。

一种简单的方法是在主程序类上加上CORS支持：

@SpringBootApplication
public class DemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }

    // 开启CORS支持
    @Bean
    public WebMvcConfigurer corsConfigurer() {
        return new WebMvcConfigurer() {
            @Override
            public void addCorsMappings(CorsRegistry registry) {
                registry.addMapping("/api/**").allowedOrigins("*").allowedMethods("GET", "POST", "PUT", "DELETE");
            }
        };
    }
}

这样就能允许来自任意域名的请求访问以/api/开头的接口。

第七步：运行并测试项目

OK，万事俱备，只欠东风！

右键运行DemoApplication.java，看到控制台显示Started DemoApplication in X seconds...就算成功启动了。

你可以使用Postman或者curl命令测试接口：

创建用户：POST http://localhost:8080/api/users

{
  "name": "Tom",
  "email": "tom@example.com"
}

获取所有用户：GET http://localhost:8080/api/users
查询单个用户：GET http://localhost:8080/api/users/1

更新用户：PUT http://localhost:8080/api/users/1

{
  "name": "Jerry",
  "email": "jerry@example.com"
}

删除用户：DELETE http://localhost:8080/api/users/1

如果一切顺利，恭喜你！你在不到一小时内完成了Spring Boot的初体验！

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

作为一个经历过Spring Boot多个版本迭代的老兵，我可以负责任地说：Spring Boot虽然简单，但也很容易踩坑。下面是几个最常见的问题和应对办法：

坑1：Spring Boot无法连接MySQL

错误提示可能是“No suitable driver”，这时候请检查：

application.properties里的URL是否正确
是否遗漏了mysql-connector-java依赖
数据库是否运行正常、可访问

坑2：JPA自动建表失败

有时候你会发现表没有创建，或者字段不符合预期。

检查spring.jpa.hibernate.ddl-auto配置
查看日志是否有建表语句输出
确保Entity类上有@Entity注解
确保字段有@Column说明

坑3：HotSwap无效（DevTools不生效）

我们在项目中添加了Spring Boot DevTools插件，目的是修改代码后不用重启。但有时修改Controller类却没生效，可能是因为：

没有启用自动编译（Build project automatically）
某些IDE缓存未清除
使用了非标准的方式启动（比如main方法之外的其他方式）

建议用快捷键Ctrl+F9触发编译，再刷新接口试试。

坑4：跨域配置不起作用

有时候即使配了CORS，浏览器还是报错。

检查是否加了@CrossOrigin注解
是否配置了多处CORS规则冲突
浏览器控制台查看具体响应头，确认是否包含Access-Control-Allow-Origin

效果总结：从一小时到持续交付

虽然这个项目只是一个入门级别的小DEMO，但它具备了一个完整后端服务的基本要素：

接口路由
数据存储
异常处理
日志输出
跨域支持
可扩展性强

正是这样一个结构清晰、易于维护的项目结构，让我们团队在后续开发中节省了大量的时间和成本。我们曾在一个星期内上线了一个小型后台管理系统，用的就是这套模板。

而且更重要的是，这种快速迭代能力在创业公司或敏捷开发中极为关键——快速验证需求 > 完美架构设计。等业务稳定了，再慢慢优化底层逻辑也不迟。

给新手的一些建议与注意事项

1. 别一开始就追求复杂架构

很多同学一开始就想整微服务、分布式事务、链路追踪……其实大可不必。先把基础打扎实，搞清楚Spring Boot是怎么工作的，再去考虑高级特性。

2. 学会在文档和源码之间切换

Spring Boot官方文档是最好的学习资料，遇到问题时优先查文档；对于某些行为不太理解的时候，可以看看它的源码实现，尤其是一些starter组件。

3. 多动手写代码，少看视频抄笔记

编程这件事，光看别人写是永远学不会的。一定要亲手敲代码，在IDE里调试、运行、出错、解决问题的过程才是真正学到东西的关键。

4. 了解Spring Boot自动装配原理

虽然自动装配带来了极大便利，但也要知道它是怎么工作的。比如条件装配、Starter依赖注入机制等，这对后续优化项目非常有帮助。

5. 注意版本兼容性

Spring Boot每年都会发布新版本，有些升级会导致API变更。尤其是Spring Boot 3以后默认使用Jakarta EE 9+，部分Spring 2.x的代码不再兼容。所以在引入第三方库时要格外注意版本适配问题。

写在最后：技术服务于业务

这篇文章一路写下来，我仿佛又回到了自己刚接触Spring Boot的那个下午。那时候我也是一边Google一边试错，折腾了一天都没搞定数据库连接。而现在，我已经能熟练地用它搭建出一套完整的后端服务。

技术本身从来不是目的，它只是实现业务目标的一种手段。学会Spring Boot并不难，重要的是你能不能把它用起来，解决实际问题。

所以，如果你是刚入门的开发者，不妨跟着这篇教程一步步走一遍。哪怕你中途卡住了、报错了也没关系，解决问题的过程才是最宝贵的经验积累。

希望这篇文章能帮你在Spring Boot的路上少走弯路。如果你还有任何疑问，欢迎留言交流！

✨ GitHub源码地址：github.com/example/springboot-demo

祝大家Coding愉快，生活顺心！👨‍💻

标签:面试题代码人生简历

最热最新

暂无评论

为你推荐

暂无相关推荐

Spring Boot 入门教程：60分钟快速上手，我的实战踩坑之路

开篇：为什么是Spring Boot？

项目背景：一个典型的CRUD需求

技术选型与前期准备

第一步：创建Spring Boot项目

1. 使用Spring Initializr生成项目骨架

2. 导入项目到IDEA

第二步：配置数据库连接

1. 修改application.properties

2. 创建数据库demo_db

第三步：定义实体类和Repository接口

1. 定义User实体类

2. 创建UserRepository接口

第四步：编写Controller层接口

第五步：处理异常与日志输出

1. 使用@ControllerAdvice统一处理异常

2. 添加日志输出

第六步：开启跨域支持（CORS）

第七步：运行并测试项目

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

坑1：Spring Boot无法连接MySQL

坑2：JPA自动建表失败

坑3：HotSwap无效（DevTools不生效）

坑4：跨域配置不起作用

效果总结：从一小时到持续交付

给新手的一些建议与注意事项

1. 别一开始就追求复杂架构

2. 学会在文档和源码之间切换

3. 多动手写代码，少看视频抄笔记

4. 了解Spring Boot自动装配原理

5. 注意版本兼容性

写在最后：技术服务于业务

评论 0

为你推荐

精选内容