Spring Boot 快速入门笔记

这篇笔记记录了一个后端新手最容易上手的 Spring Boot 实践路径：先跑通最小可运行项目，再逐步加数据库、接口分层和统一异常，避免一上来就把复杂度拉满。

1. 初始化工程

建议通过脚手架创建 Maven 项目，Java 版本统一到 17，并先引入 Web、Validation、MySQL Driver、MyBatis（或 JPA）等常用依赖。这样第一天就能覆盖多数业务接口场景。

SpringApplication.run(DemoApplication.class, args);

启动成功后，先用一个最简单的健康检查接口验证环境，确保本地端口、JDK、依赖下载都没有问题。

2. 目录结构建议

• controller：只做参数接收与响应返回，不写业务逻辑
• service：聚合业务流程，封装事务边界
• mapper/repository：专注数据库访问
• common：统一响应体、异常、工具类、常量

3. 常见接口开发流程（示例）

以“新增学生信息”接口为例，推荐流程是：参数校验 → 业务校验（如学号唯一）→ 写库 → 返回标准响应。不要把所有判断都堆在 Controller 里。

POST /api/students
{
  "studentNo": "2026001",
  "name": "张三",
  "major": "软件工程"
}

当参数不合法时，统一抛出业务异常并在全局异常处理器中转换为规范错误码，前端就能稳定地做提示处理。

4. 本地联调与排错

• 优先查看启动日志中的端口与数据库连接信息
• 接口 404 多半是路径或扫描包配置问题
• 接口 500 优先看异常栈顶部的根因类名
• 联调阶段先固定一套测试数据，避免“数据问题”和“代码问题”混在一起

5. 小结

Spring Boot 入门最重要的不是“写了多少代码”，而是尽早建立清晰的项目骨架和开发习惯。把分层、校验、异常、日志这四件事做扎实，后续功能迭代会非常顺畅。

← 返回首页