想上手Spring Boot最大的困扰往往不是“不会写代码”而是“不知道从哪开始”。网上资料铺天盖地有讲注解的、有讲配置的、有直接甩一个商城项目的初学者很容易被各种概念淹没搞不清到底先学什么、重点抓什么。这篇东西就是给准备入门或者刚入门的你准备的我会从Spring Boot解决了什么问题讲起一步步带你创建第一个项目、写完第一个接口然后把配置、日志、Bean注入这几个必须跨过的坎掰开揉碎讲清楚再结合我实际用过的WebSocket、Caffeine、MinIO集成场景做一次实操展示。最后针对Java 21 Spring Boot 3.5的虚拟线程新特性、以及校园讲座预约系统、商城这类常见设计题目我也会聊聊我的做法和踩坑经验。这篇文章适合谁看正在学Spring Boot的学生、刚转Java后端的开发者以及准备拿Spring Boot做毕业设计但不知道从哪下手的同学。我会尽量少说废话把“为什么这么做”和“我是怎么踩坑的”都讲透你看完至少能独立写一个能跑的项目遇到常见的启动报错也不会慌。1. 动手之前先把Spring Boot的定位搞清楚1.1 Spring Framework、Spring Boot、Spring Cloud到底啥关系这大概是新手问得最多的问题。我在带新人时经常发现很多人Spring Boot写了一两个月还是没搞明白它和Spring的区别更别提Spring Cloud了。简单说Spring Framework是一个完整的编程和配置模型核心是控制反转IoC和面向切面编程AOP它把对象的创建、装配、生命周期都接管了。你要用Spring原生开发得手动引入各种依赖、写大量XML配置还得自己搞定Web服务器、数据库连接池、事务管理这些基建。不是说不行而是太费劲。Spring Boot是在Spring Framework基础上做的一套自动化封装。它用“约定大于配置”的思路把大部分繁琐的配置都变成默认值。你只要引入对应的起步依赖Starter框架就自动帮你把能配的都配好。比如引入spring-boot-starter-web它就自动内置Tomcat、自动配置DispatcherServlet、自动扫描你的Controller不需要你像以前那样去配置web.xml。这就是那句“快速上手”的底气来源。Spring Cloud则是建立在Spring Boot之上的微服务套件提供服务注册发现、配置中心、网关、熔断这些分布式能力。三者是一条链上的Spring Framework是地基Spring Boot是让你快速把房子盖起来的施工队Spring Cloud则是给整个小区做水电网配套的。这里有句我常对新人说的话先把Spring Boot用熟再去碰Spring Cloud。别一上来就追微服务单体都没写过几个直接上分布式只会让你怀疑人生。1.2 Spring Boot真正帮你省了什么我举一个最具代表性的例子想写一个能处理HTTP请求的Web服务原生Spring需要什么你需要引入spring-webmvc、spring-web等好几个依赖然后写web.xml或JavaConfig配置DispatcherServlet注册ContextLoaderListener配置视图解析器、静态资源映射还要把Controller类手动注册进去。这一套下来就算复制粘贴一个新人没半小时搞不定。Spring Boot呢在pom.xml里加上spring-boot-starter-web写一个带SpringBootApplication注解的启动类再写一个RestController完事。启动类运行起来接口就能访问了。真的只需要三步。它省掉的配置不是一星半点是把你从“搭建环境”中彻底解放出来让你专心写业务代码。另一个核心机制是自动配置AutoConfiguration。你在pom里加了什么依赖它就尝试自动装配对应的Bean。比如你加了spring-boot-starter-data-redis它会自动帮你创建RedisTemplate和连接工厂你加了mybatis-spring-boot-starter它自动帮你配置数据源和SqlSessionFactory。当然它不是瞎配每个自动配置类上都有ConditionalOnClass、ConditionalOnMissingBean这类条件注解只有当类路径存在相应依赖、且你没有显式定义自己的Bean时它的默认配置才会生效。理解了这个机制后面遇到“我明明依赖都加了为什么Bean还是没生效”这类问题你就知道往哪个方向排查了。2. 十分钟创建你的第一个Spring Boot项目2.1 用Spring Initializr把项目“生”出来创建项目的方式有好几种我个人最推荐用Spring Initializr也就是start.spring.io。打开网站你看到的界面有几个关键选项构建工具选Maven还是Gradle、语言选Java还是Kotlin、Spring Boot版本选哪个以及右侧那一大堆依赖。我的建议是构建工具选Maven因为国内团队用Maven的明显居多网上的大部分教程和资料也都是基于Maven的出了问题好搜语言选Java别折腾Spring Boot版本如果你是学习用途直接选最新的稳定版就行写这篇内容时3.5.x已经支持Java 21甚至更新的JDK但如果你是要做毕业设计或者公司项目稳妥一点就选2.7.x或3.2.x这种被广泛验证过的版本。具体怎么选我在第7节的版本问题排查里会详细说。依赖方面第一次练手只需要勾选Spring Web就够了。等你熟悉了流程再按需加MyBatis、MySQL Driver、Redis这些。很多人一开始喜欢把所有能勾的依赖都勾上结果项目还没开始写启动就报一堆环境依赖错误这不是给自己挖坑嘛。生成压缩包后解压用IDEA选择对应的Maven项目导入等依赖下载完就可以用了。如果下载速度慢就把Maven镜像换成阿里云的这个细节能给新人省很多时间。2.2 第一个接口代码怎么写项目跑起来的标志不是IDEA里没有红叉而是你能在浏览器里访问到自己写的接口。第一步先把启动类找出来一般长这样SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }SpringBootApplication是个组合注解它包含了SpringBootConfiguration继承自Configuration、EnableAutoConfiguration和ComponentScan。换句话说这个注解不只是标记个“启动类”那么简单它同时开启了自动配置和组件扫描。默认扫描范围是启动类所在包及其子包。这就是为什么约定俗成要把启动类放在最外层包路径下。然后我在同级包下新建一个controller包写一个最简单的接口RestController public class HelloController { GetMapping(/hello) public String hello() { return Hello, Spring Boot!; } }这里有两点新手容易弄混。第一RestController是Controller和ResponseBody的组合意思是这个类的所有方法返回值直接作为HTTP响应体写回不再经过视图解析器。你如果写的是Controller接口默认会去找对应的模板页面就会报404。第二GetMapping(/hello)表示把GET请求的/hello路径映射到这个方法上。想接收POST请求就用PostMapping想匹配多种请求方式就写RequestMapping。运行启动类的main方法控制台出现“Tomcat started on port(s): 8080”就说明成了。打开浏览器输入http://localhost:8080/hello看到“Hello, Spring Boot!”这行字你的第一个Spring Boot程序就跑通了。这个“第1关”其实就这么简单很多时候卡住不是因为代码有问题而是环境、依赖、启动方式哪里没对齐。2.3 项目结构怎么看、怎么改解压后的项目结构有一定讲究我挑重点说。src/main/java存放Java代码包名一般是com.xxx.demo这样的反向域名再往下是controller、service、mapper、entity这些按职责分的包。src/main/resources存放配置文件核心是application.properties或application.yml如果你用了MyBatisMapper的XML文件一般放在resources/mapper/下面。src/test/java放单元测试代码。pom.xml是Maven项目的核心所有依赖、插件、打包配置都在这里。Spring Boot的parent依赖帮你统一管理了一堆依赖版本这也是它能做到“不用写版本号”的原因。当你引入第三方依赖需要指定版本号时也得在pom里操作。真实开发中我建议从一开始就养成良好的分层习惯。Controller层只管接收参数和返回结果业务逻辑写在Service层数据访问在Dao/Mapper层实体对象单独放entity包。不要图省事把SQL逻辑写在Controller里短时间看着方便项目一大必然后悔。3. 配置、日志、Bean注入三天内必踩的三大关3.1 application.yml配置那些坑Spring Boot支持两种配置文件格式properties和yml。properties是老格式keyvalue的写法yml靠缩进表达层级阅读性更强。我推荐用yml但现在新项目两种都在用你至少要能看懂properties格式的配置免得接手老项目时一脸懵。拿一个典型的yml配置来拆解server: port: 8081 servlet: context-path: /api spring: datasource: url: jdbc:mysql://localhost:3306/school_lecture?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai username: root password: 123456 driver-class-name: com.mysql.cj.jdbc.Driver redis: host: localhost port: 6379注意几个压箱底的要点。第一冒号后面必须有空格否则解析报错。这个错误报错信息还特别不明显新手经常盯着看半天不知道哪错了。第二缩进用两个空格不要用Tab。第三生产环境不要用明文密码至少要用环境变量占位比如password: ${DB_PASSWORD}真实密码放在部署环境的变量里。除了全局配置还有按环境拆分的配置方式。比如application-dev.yml是开发环境、application-prod.yml是生产环境然后通过spring.profiles.activedev来指定激活哪套。我最早接手项目时没这个概念把测试环境的数据库地址直接写在生产配置里结果上线第一天就被人骂了。记住多环境配置是规范不是选做题。3.2 日志配置别再用System.out写练习代码时用System.out.println打印信息无可厚非但到了真实项目里我见过有人生产事故排查时翻了半天控制台才发现关键日志被其他输出刷掉了根源就是生产代码里布满了System.out。Spring Boot默认用的是Logback你不需要额外引入日志依赖只需要在application.yml里做配置。最实用的一段配置长这样logging: level: root: info com.example.demo: debug file: name: logs/app.log logback: rollingpolicy: max-file-size: 10MB max-history: 7这段配置的意思是全局日志级别是info但com.example.demo包下的类使用debug级别方便开发时看到更多细节日志输出到logs/app.log文件单个文件超过10MB自动切割历史日志保留7份。生产环境按天或者按大小切割是非常必要的不然日志文件能撑爆磁盘。代码里用日志也有讲究。定义一个logger的规范写法是private static final Logger log LoggerFactory.getLogger(OrderService.class);如果你用的Lombok可以直接用Slf4j注解代码更简洁。需要提醒的是日志级别按error warn info debug trace递减业务关键节点记info异常情况下记error并附带堆栈调试细节记debug。别把密码、token这类敏感信息打到日志里这是合规底线。3.3 Bean注入的三种写法和优先级Spring Boot里到处是Bean理解注入机制很重要。新人最常见的困惑是怎么拿到别人写好的类答案是让Spring管理对象生命周期也就是在类上标注Component或Service、Repository、Controller它们都是Component的语义化变体Spring启动时自动创建实例放进容器其他类需要时把它“注入”进来。注入方式有三种。字段注入直接在成员变量上标AutowiredAutowired private OrderService orderService;构造器注入写一个构造方法Spring自动把依赖传进来private final OrderService orderService; public OrderController(OrderService orderService) { this.orderService orderService; }Setter注入在setter方法上标Autowired。实际操作里我强烈推荐构造器注入。原因很简单依赖关系清晰对象创建时强制要求依赖完整配合final关键字还能保证不可变。字段注入虽然写起来最省事但问题不少比如不方便单元测试没法通过构造器传入Mock对象、隐藏了依赖关系类一复杂你根本看不出它到底需要哪些Bean。Spring官方文档也明确推荐构造器注入所以别图省事。另外要分清Autowired和Resource。Autowired是Spring提供的按类型注入Resource是JDK提供的按名称注入。默认情况下两者都能用但如果你有一个接口多个实现类就必须通过Qualifier(beanName)指定或Resource(name beanName)指定。我刚工作那会儿不知道这茬一个业务接口写了两个实现类结果启动时直接报NoUniqueBeanDefinitionException那次印象太深刻了。控制Bean注入的还有一个常用场景是条件装配。比如你希望某个Bean只在某个配置项存在时才创建可以用ConditionalOnProperty(name cache.enabled, havingValue true)。这种玩法在写中间件、封装组件时特别多等你有经验了自然会遇到。4. 常用集成实操WebSocket、Caffeine、MinIO一个不少4.1 WebSocket YAML配置实例现在不少业务场景需要服务器主动推送消息比如讲座预约系统的座位变动通知、商城的订单状态推送用轮询太浪费资源WebSocket就派上用场了。Spring Boot集成WebSocket并不复杂。第一步在pom.xml里加依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-websocket/artifactId /dependency然后在config包下写一个配置类Configuration EnableWebSocket public class WebSocketConfig implements WebSocketConfigurer { Override public void registerWebSocketHandlers(WebSocketHandlerRegistry registry) { registry.addHandler(new LectureNotifierHandler(), /ws/lecture) .setAllowedOrigins(*); } }这里setAllowedOrigins(*)在正式环境得谨慎线上一般要指定允许的域名。WebSocket的跨域检查和HTTP跨域是两套体系只在Controller上加CrossOrigin没作用这个坑我在第一次集成时踩过查了半天。Handler类需要继承TextWebSocketHandler重写afterConnectionEstablished和handleTextMessage等方法。需要注意WebSocket长连接会占用大量资源连接建立后一定要有心跳检测机制服务端定期ping长时间没响应的连接及时关闭。曾经我们线上出现过连接数暴涨把Tomcat线程池打满的情况排查下来就是连接没做空闲回收。至于“WebSocket的yml配置”其实官方并没有那么多可配的东西。你可以在application.yml里通过spring.websocket.paths的配置来指定端点路径但大多数情况下直接写Java配置就足够了。更关键的是调好Servlet容器的队列容量和空闲超时参数这些才是保证WebSocket稳定运行的重点。4.2 Caffeine本地缓存怎么配缓存这东西几乎所有项目都用得上。Caffeine是目前Java生态里口碑最好的本地缓存库性能比Guava Cache还要好。Spring Boot 2.0以后对于缓存有统一抽象你只要引入Caffeine依赖并在配置里指定缓存类型就能无缝使用Cacheable注解。具体做法先在pom.xml加依赖dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-cache/artifactId /dependency dependency groupIdcom.github.ben-manes.caffeine/groupId artifactIdcaffeine/artifactId /dependency在启动类上标EnableCaching然后写一个配置类定义CacheManagerConfiguration public class CacheConfig { Bean public CacheManager cacheManager() { CaffeineObject, Object caffeine Caffeine.newBuilder() .initialCapacity(128) .maximumSize(1024) .expireAfterWrite(Duration.ofMinutes(10)); return new CaffeineCacheManager(lectures, orders); } }具体业务方法上这样用Cacheable(value lectures, key #lectureId) public Lecture getLectureById(Long lectureId) { return lectureMapper.selectByPrimaryKey(lectureId); }只要参数相同第二次调用就不会进方法体。注意Cacheable默认缓存的是返回值所以方法返回的对象最好是不可变的万一别处去改了缓存里的对象后面所有读取都会受影响。另外缓存失效问题也是高并发场景的经典坑你可以配合CacheEvict在更新数据时主动清除相关缓存。Caffeine作为本地缓存有个天然局限多实例部署时各机器的缓存并不共享。做讲座预约系统这类单机部署没问题但真要上分布式架构就得考虑Redis这类集中式缓存或者引入Caffeine Redis二级缓存的方案。本地缓存命中率高、快Redis统一管理、一致性好两者结合能兼顾性能和一致性。不过二级缓存带来的复杂度不小建议项目初期先用一种就好。4.3 MinIO对象存储集成记录做办公用品管理系统或者商城项目总会遇到文件上传。把文件存本地磁盘运维扩容麻烦把文件存数据库又大又慢。常见的方案是用OSS对象存储商业的有阿里云OSS、腾讯云COS开源里最有名的就是MinIO。MinIO兼容Amazon S3协议可私有化部署对学习和小团队项目非常友好。集成MinIO分三步。第一步引入依赖并在yml里配置服务地址和密钥minio: endpoint: http://localhost:9000 access-key: minioadmin secret-key: minioadmin bucket-name: lecture-bucket第二步创建一个配置类读取这些配置并把MinioClient注册为Bean。第三步封装一个上传下载工具。上传的核心代码大概就是public String upload(MultipartFile file, String objectName) throws Exception { InputStream inputStream file.getInputStream(); minioClient.putObject( PutObjectArgs.builder() .bucket(bucketName) .object(objectName) .stream(inputStream, file.getSize(), -1) .contentType(file.getContentType()) .build()); return /file/ objectName; }需要注意文件重名问题。直接拿用户原始文件名存入MinIO两人传同一个名字的文件就会相互覆盖。常规做法是用UUID或时间戳拼原始名生成新文件名。注意putObject的stream方法第三个参数是指分片大小传-1表示不知道总大小由SDK自动处理但必须要传对总长度否则上传大文件会报错。这些细节出错时提示并不直观我当年调试了半天才明白。5. Java 21 Spring Boot 3.5虚拟线程初体验5.1 虚拟线程配置与原理Java 21正式引入了虚拟线程。传统上每个请求由一个操作系统线程承载线程切换开销大、数量有限制。虚拟线程则是由JVM调度的轻量级线程数量可以开到十万甚至百万级它们的切换和调度完全由JVM管理而不是操作系统。用行话说这是在高并发场景下“用更小的成本扛更大的流量”。Spring Boot 3.2开始支持虚拟线程到了Spring Boot 3.5配合Java 21体验已经相当成熟。开启方式极其简单在application.yml里写一段配置spring: threads: virtual: enabled: true设置之后Spring MVC的请求处理线程池会从平台线程切换成虚拟线程。你可以做个压测对比同样一台机器固定200个并发请求传统线程池模式下线程数很快就打满了响应时间蹭蹭往上长开启虚拟线程后Tomcat这边等于“每请求一线程”的模式吞吐量能有明显提升。我这里说的都是普通业务场景下的体感具体数值和你的应用类型强相关别拿这个当基准。5.2 虚拟线程的几个注意点虚拟线程虽好但几个坑必须先知道。第一个坑不要在虚拟线程里用synchronized块锁住耗时操作。因为虚拟线程在遇到阻塞时会先释放底层载体线程去执行别的虚拟线程但如果被synchronized锁挡住了底层载体线程不会释放高并发下照样卡成狗。需要同步的时候优先用java.util.concurrent包下的Lock和Semaphore它们能够更好地配合虚拟线程的调度机制。第二个坑ThreadLocal要慎用。虚拟线程数量巨大ThreadLocal的回收不像平台线程那样可控用多了容易内存膨胀。能不用就不用非要传递上下文就考虑使用参数传递或者框架提供的上下文对象。我认识的一个团队把Job调度系统升级到虚拟线程后频繁出现内存溢出最终查下来就是老代码里的ThreadLocal没清理干净。第三个坑不是所有依赖都对虚拟线程友好。旧版的Redis客户端、某些RPC框架的线程池管理在虚拟线程下可能会出现奇怪的行为。升级前先用小流量测试别一上来就全量替换。这点对于生产部署非常关键。6. 从练习到毕设商城、预约系统的设计套路6.1 校园讲座预约系统怎么拆很多人的毕业设计题目就是“基于Spring Boot的校园讲座预约系统”“基于Spring Boot的企业办公用品管理系统”这类题目的核心不在技术多新而在于业务逻辑完整、功能闭环。拿讲座预约系统举例你可以从几个维度去拆。用户维度登录注册、个人信息维护、查看讲座列表、预约讲座、取消预约、查看我的预约记录。管理员维度讲座信息发布、修改、下架查看报名情况导出到场名单。这是最基础的功能需求在答辩时属于“必须完成”的部分。技术选型上三层架构加MyBatis-Plus是主流组合。MyBatis-Plus在MyBatis基础上封装了通用CRUD和分页插件写起来效率和可读性都很好。数据库设计至少要有用户表、讲座表、预约记录表这三张核心表预约记录表要维护一个状态字段比如0已预约、1已签到、2已取消、3已过期。我多年帮人看项目得出一个体会这种系统最能体现拉开差距的地方其实是几个容易被忽视的细节。一是重复预约校验同一用户同一场讲座不能生成两条预约记录这个约束要在代码层面加锁或靠数据库唯一索引兜底否则并发点击几下就会出现脏数据。二是余票扣减的并发安全用乐观锁版本号机制比较适合这个场景在更新时带上“剩余票数大于0且版本号匹配”的SQL条件。三是取消预约的时间边界讲座开始前X小时不允许取消这种规则看起来简单但漏了状态判断就会出逻辑漏洞。6.2 商城、办公用品管理系统CRUD之外的加分项商城类题目像“Spring Boot设计题目商城”很容易被写成一堆CRUD页面的堆砌。想拿高分你至少要在几个点上做出深度。用户登录认证方面别再用传统的Session方案了用JWT实现无状态认证。用户登录成功后服务端签发一个token前端后续请求在Header里带上后端用一个拦截器校验token并解析出用户信息。这块代码网上方案很多但你要理解为什么要选JWT系统扩展成多实例时Session同步是个麻烦事JWT天然不需要服务端存储会话状态。安全上要区分普通用户和管理员角色菜单和接口按角色做权限控制。事务处理也很关键下单这个动作涉及扣库存、生成订单、支付记录三个写操作任何一个失败都必须整体回滚。实现方式是在Service方法上加Transactional但要注意事务失效的经典场景方法内部的this调用不会经过Spring代理加上也没用一定要通过注入的Bean调用异常默认只在RuntimeException时回滚如果你的代码抛了检查异常但不回滚就得在注解里指定rollbackFor。另外一个加分项是统一响应体。不要每个Controller都返回裸的Map或者直接返回实体类定义一个Result 泛型类包裹所有返回数据前端处理逻辑瞬间统一状态码、消息、数据三段式结构清晰规范。配合全局异常处理器RestControllerAdvice把业务异常和系统异常统一转成规范响应体而不是把500页面直接扔给前端。这一套做完答辩时技术亮点拉满。6.3 代码组织建议这类项目代码规范上我见过太多反面教材。给几个具体可执行的建议第一Controller里的方法尽量只做三件事接收参数、调用Service、返回结果。不要塞业务判断和SQL调用。第二表结构字段名用下划线风格Java实体用驼峰命名让MyBatis-Plus的驼峰转换配置帮你自动对齐。第三不要在循环里查数据库能批量查询就批量查询这个习惯在写商城购物车、订单列表这类接口时特别重要。第四常量不要散落各处用户状态、订单状态这类字段要定义成枚举或者常量类不然项目写到最后value值1/2/3到底代表什么状态只有天知道了。做好这些代码组织维度的事胜过你在答辩PPT里吹十页技术术语。7. 常见问题排查实录7.1 依赖版本匹配表版本不匹配是新手项目起不来的头号原因。我整理过一份常用的对应参考记住一个大致规律就够用场景推荐版本/兼容关系Spring Boot 2.7.xJDK 8-17对应Spring Framework 5.3Spring Boot 3.0-3.1JDK 17对应Spring Framework 6.0Spring Boot 3.2JDK 17-21支持虚拟线程Spring Boot 3.5.xJDK 17-21当前较新稳定版MyBatis-Plus3.5.x兼容Spring Boot 2/3MinIO Java SDK8.x版本均可Caffeine3.x与Spring Boot 2/3都兼容还有个经典问题引入了某个第三方包时因为Spring Boot父依赖没有托管它的版本你就要手动指定版本号。比如Grpc集成时protobuf和grpc-spring-boot-starter的版本对应关系不能乱配Redis客户端Lettuce从Spring Boot 3升级后默认版本已经换过了。原则上第三方依赖优先选官方文档明确支持Spring Boot 3的版本别用几年前的老包硬怼。7.2 启动失败的典型原因清单我总结过启动失败最常见的几类问题绝对覆盖你80%的启动报错。端口被占用是本级报错。报错信息一般是“Port already in use: 8080”。Windows下用netstat -ano | findstr 8080查出占用进程的PID然后任务管理器结束进程或者直接在yml里换一个端口完事。开发时我经常切换项目8080被之前的服务占用是家常便饭。数据库连接失败是最容易区分情况的错误。如果提示“Access denied for user”检查用户名密码、数据库IP对不对如果提示“Unknown database”说明数据库还没创建或者库名写错。MySQL 8的驱动类要改成com.mysql.cj.jdbc.Driver老项目的com.mysql.jdbc.Driver虽然在兼容模式下没报错但也是该改的。Bean创建失败则是最需要看堆栈的一类。比如“No qualifying bean of type xxx available”要么是该类忘了标Component要么是多实现类没指定Primary或Qualifier。遇到这类错误直接定位到报错行附近的Bean定义基本很快能找到原因。配置文件解析失败时报错会提示yml文件第几行有问题。90%的情况是冒号后没空格或缩进混乱。第二个常见问题是字符串值忘了加引号比如“”开头的字符串、带冒号的字符串yml会解析出你意想不到的结果。这类错误不好找建议配置力不高的时候直接用IDE的yaml插件检查。7.3 接口报错的排查顺序接口异常排查是有套路可循的按顺序来更高效。先看服务控制台日志找到对应的异常堆栈。很多新手第一反应是打开Postman反复发请求但后端什么都没打印说明请求根本没到达你的代码里重点就得查路径映射对不对、有没有被拦截器拦截。再接着看HTTP状态码404是路径不对403是权限拦截器拦了500才是代码抛异常。最后是检查数据库如果SQL能打印出来拿着SQL手动在数据库客户端执行一遍很多时候数据问题一眼就能看出来。整个排查过程最忌讳的是猜。不要凭感觉去改配置、改代码先看日志日志才是最能说真话的那位。实操心得写在最后这几年代人入门Spring Boot我最大的体会是这个框架确实把上手门槛降得非常低但越是容易上手的东西越要在基础上扎扎实实。有些同学依赖自动配置用得很溜但问起“为什么引入这个Starter Bean就自动生效了”答不上来。这种状态写写小项目没问题一旦进了团队做复杂项目遇到稀奇古怪的报错就抓瞎了。最后再分享一个小技巧遇到报错时别急着复制粘贴到搜索引擎先完整读一遍异常信息。异常堆栈从最底部往上读第一张长堆栈的最顶端往往才是真正的根因。你如果能养成先看堆栈再动手的习惯Spring Boot这条路会走得顺利很多。框架迭代很快但排查问题和理解原理的能力永远能让你在技术浪潮中立得住脚。