Spring Boot 从入门到实战开发指南

五、Spring Boot 项目核心结构解析

springboot-demo // 项目根目录
├── src
│   ├── main
│   │   ├── java
│   │   │   └── com.demo // 你的包名
│   │   │       ├── SpringbootDemoApplication.java // 项目启动类【核心】
│   │   │       ├── controller // 控制层：写接口的地方【核心】
│   │   │       ├── service // 业务层：写业务逻辑的地方【核心】
│   │   │       ├── mapper // 数据层：操作数据库（MyBatis）
│   │   │       └── pojo // 实体类：封装数据
│   │   └── resources
│   │       ├── application.properties // 全局配置文件【核心】
│   │       ├── static // 静态资源：css、js、图片
│   │       └── templates // 模板页面：thymeleaf
│   └── test // 测试目录
└── pom.xml // Maven 核心文件：管理依赖和项目配置【核心】

核心文件说明

• 启动类：项目的入口，带有 @SpringBootApplication 注解，运行这个类的 main 方法，项目就启动了。一个项目只能有一个启动类，且启动类要放在所有业务包的最外层。
• 配置文件：application.properties 或 application.yml，支持两种格式，两者任选其一即可。
• Maven 文件：pom.xml，管理项目的所有依赖，比如我们引入的 Spring Web、MyBatis 等。

启动类示例：

package com.demo;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

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

六、第一个 Spring Boot 接口：Hello World

步骤 1：创建 Controller 控制层

在 com.demo 包下新建 controller 包，然后创建 HelloController.java 类：

package com.demo.controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {
    @GetMapping("/hello")
    public String hello() {
        return "Hello Spring Boot!";
    }
}

核心注解解释

• @RestController：组合注解 = @Controller + @ResponseBody，将方法的返回值直接以 JSON / 字符串的形式返回给前端。
• @GetMapping("/hello")：指定接口的请求方式为 GET，请求路径为 /hello。

步骤 2：启动项目，测试接口

1. 找到启动类 SpringbootDemoApplication.java，右键点击「Run」，启动项目。
2. 启动成功后，控制台会打印日志，看到 started ... 说明启动成功。
3. 测试方式：打开浏览器，输入地址 http://localhost:8080/hello，回车就能看到返回的字符串。

提示：Spring Boot 默认端口是 8080，如果端口被占用，在 application.properties 中配置：server.port=8081 即可修改端口。

七、Spring Boot 核心实战开发

实战 1：全局统一返回结果封装

实际开发中，后端接口的返回格式必须统一、规范。无论接口成功还是失败，都要返回相同的 JSON 结构。

步骤 1：创建统一返回结果实体类

package com.demo.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@AllArgsConstructor
public class Result {
    private Integer code;
    private String msg;
    private Object data;

    public static Result success() {
        return new Result(200, "操作成功", null);
    }

    public static Result success(Object data) {
        return new Result(200, "操作成功", data);
    }

    public static Result error(String msg) {
        return new Result(500, msg, null);
    }
}

需要在 pom.xml 中引入 lombok 依赖：

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

步骤 2：改造接口，返回统一结果

@GetMapping("/user/{id}")
public Result getUserById(@PathVariable Integer id) {
    if (id == 1) {
        User user = new User(1, "张三", 22, "Java 后端开发者");
        return Result.success(user);
    } else {
        return Result.error("用户不存在");
    }
}

同时创建 User 实体类：

package com.demo.pojo;
import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {
    private Integer id;
    private String name;
    private Integer age;
    private String desc;
}

访问 http://localhost:8080/user/1，返回的 JSON 格式如下：

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 1,
    "name": "张三",
    "age": 22,
    "desc": "Java 后端开发者"
  }
}

实战 2：全局统一异常处理

Spring Boot 提供了全局异常处理机制，通过 @RestControllerAdvice + @ExceptionHandler 注解，能统一捕获项目中所有的异常。

步骤 1：创建全局异常处理类

package com.demo.exception;
import com.demo.pojo.Result;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice;

@RestControllerAdvice
public class GlobalExceptionHandler {
    @ExceptionHandler(RuntimeException.class)
    public Result handleRuntimeException(RuntimeException e) {
        e.printStackTrace();
        return Result.error("服务器内部错误：" + e.getMessage());
    }

    @ExceptionHandler(Exception.class)
    public Result handleException(Exception e) {
        e.printStackTrace();
        return Result.error("系统异常，请联系管理员");
    }
}

实战 3：接口参数校验

后端接口接收前端传递的参数时，必须做参数合法性校验。Spring Boot 整合了 JSR380 规范，通过 @Valid + 校验注解 就能实现优雅的参数校验。

步骤 1：引入参数校验依赖

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

步骤 2：在实体类中添加校验注解

@Data
@NoArgsConstructor
@AllArgsConstructor
public class User {
    private Integer id;
    
    @NotBlank(message = "用户名不能为空")
    private String name;
    
    @Min(value = 0, message = "年龄不能为负数")
    @Max(value = 150, message = "年龄不能超过 150")
    private Integer age;
    
    private String desc;
}

步骤 3：在接口中添加 @Valid 注解开启校验

@PostMapping("/user/add")
public Result addUser(@Valid @RequestBody User user) {
    return Result.success("用户添加成功");
}

八、项目打包与部署

Spring Boot 项目开发完成后，需要打包部署到服务器运行。打包非常简单，打包后是一个可执行的 jar 包，内置了 Tomcat。

步骤 1：打包项目

在 IDEA 右侧找到「Maven」面板，展开项目 → 生命周期 → 双击「package」，开始打包。

步骤 2：运行 jar 包

打开命令行，进入 jar 包所在的目录，执行以下命令即可启动项目：

java -jar springboot-demo-0.0.1-SNAPSHOT.jar

九、总结与学习建议

本文核心知识点总结

1. Spring Boot 的定义和核心优势，理解为什么它是后端开发的主流框架；
2. 两种快速搭建 Spring Boot 项目的方式，以及项目的核心目录结构；
3. 入门案例 Hello World，掌握了 @RestController、@GetMapping 等核心注解；
4. 企业级必备的三大实战技能：统一返回结果、全局异常处理、接口参数校验；
5. 项目的打包与部署，学会了如何将项目打包成 jar 包并运行。

学习建议

1. 先吃透基础，再谈进阶：先把本文的知识点全部掌握，再去学习整合 MyBatis 操作数据库、Redis 缓存等进阶技术；
2. 多敲代码，少看视频：把本文的所有代码都手动敲一遍，运行成功，理解每一行代码的含义；
3. 遇到问题先自己排查：学会看控制台日志，尝试自己解决问题；
4. 保持学习的热情：Java 后端开发需要学习的东西很多，但只要一步一个脚印，循序渐进，你一定会成长。

Spring Boot 是 Java 后端开发的基石，希望这篇教程能帮你快速入门并掌握核心实战技能。