我最近在带几个完全零基础的同事转Java方向发现一个很普遍的现象大家一说学Spring Boot第一反应就是去搜“SSM框架教程”然后从Spring的IOC容器、Bean生命周期开始啃啃了两个星期连一个能跑的HelloWorld都没写出来。这种学法其实完全反了——Spring Boot之所以叫Boot就是因为它把“启动”这件事的门槛降到了最低。你不需要先搞懂底层一堆设计模式也能把项目跑起来而全栈开发入门最需要的恰恰就是“先把东西跑起来”的正反馈。这篇文章就是写给编程小白看的Spring Boot入门指南。我会尽量把每一个概念都讲成人话每一步都给出可以直接照抄的操作同时把那些网上教程通常不会写、但实际开发中一定会遇到的细节和坑一并塞给你。不管你是刚毕业的学生、想转行的非科班还是已经会一点Java但被Spring全家桶劝退过的人跟着这篇文章走一遍你就能拥有一个真正属于自己的全栈项目地基。1. 学Spring Boot之前先把“它到底解决了什么”想清楚1.1 在Spring Boot之前SSH/SSM那套配置有多折腾很多新人看老教程会一脸懵为什么以前的Spring项目里会有那么多applicationContext.xml、springmvc-servlet.xml、web.xml为什么引入一个依赖还要自己去下载jar包、处理版本冲突为什么部署的时候要把项目打成war包再塞进Tomcat这些问题的根源在于早期的Java Web开发——也就是常说的SSHStruts2 Spring Hibernate或SSMSpring SpringMVC MyBatis——把大量精力浪费在了“配置”而不是“业务”上。我当时照着教程搭一个HelloWorld光配置文件就写了上百行还经常因为某个jar包版本对不上而启动报错一调就是一下午。这种体验对零基础的人来说基本等于劝退。Spring Boot的诞生就是为了终结这种“配置地狱”。它把“搭建项目”这件事从“手动拼装一堆零件”变成了“选好套餐直接开车”。1.2 用生活类比理解三个核心设计要理解Spring Boot先记住三个词约定优于配置、Starter依赖、独立运行。约定优于配置好比你去宜家买家具说明书告诉你“螺丝A拧进孔B”你照着做就行不需要自己去设计哪颗螺丝该拧在哪。Spring Boot规定了一套默认的项目结构、默认的配置文件名、默认的端口号你只要遵循这个约定框架就自动帮你把环境搭好。Starter依赖好比你去餐厅点“一人食套餐”而不是分别去买米、买菜、买调料再自己做。比如你想开发Web接口只需要引入spring-boot-starter-web这一个依赖它会把SpringMVC、内嵌Tomcat、JSON处理工具等一系列必要依赖一次性打包给你互相之间版本还已经帮你调好了。独立运行Spring Boot应用内部内置了Tomcat等Web服务器所以你可以像运行普通Java程序一样直接跑起来不需要单独安装Tomcat、配置部署目录。这在开发和部署时的省心程度用过的人都知道。1.3 “全栈开发”里Spring Boot到底占哪一层常有人问我全栈开发是不是就是“前端后端”都会是但不完整。一个合格的全栈项目至少包含前端页面、后端接口、数据库设计、部署运维四个部分。Spring Boot负责的是其中最核心的后端接口层——它接收前端过来的HTTP请求处理业务逻辑读写数据库再把结果返回给前端。所以我建议你把Spring Boot理解成“整个项目的中枢”。前端可以随便换Vue、React甚至小程序数据库也可以换MySQL、PostgreSQL只要后端接口是Spring Boot提供的整个系统转起来就非常顺畅。这也是为什么很多开源项目比如各种电商商城系统、就业推荐系统的后端都选它。2. 环境准备JDK、Maven、IDE三件套怎么选、怎么验2.1 JDK到底选哪个版本先说结论如果你是新学直接装JDK 17LTS长期支持版本。别纠结别选JDK 8也别追JDK 21。原因很简单JDK 8太老很多新特性不支持JDK 17是目前Spring Boot 3.x的默认基线网上最新的教程和开源项目基本都在用它遇到问题搜资料也最好搜。安装JDK之后一定要在命令行里确认环境变量配置成功java -version javac -version看到版本号输出还不算完再敲一句echo $JAVA_HOMEWindows用户敲echo %JAVA_HOME%。如果输出为空说明JAVA_HOME没配好很多工具后面要用的Maven会找不到Java。这里特别提醒一句环境变量里配JAVA_HOME的路径一定要指到JDK安装目录的上一级而不是bin目录比如C:\Program Files\Java\jdk-17不是C:\Program Files\Java\jdk-17\bin。2.2 Maven别急着配服务器先搞懂镜像Maven是Java项目的依赖管理和构建工具。它的作用通俗讲就是你告诉它“我要用MySQL驱动”它自动去仓库下载jar包并管理版本。安装Maven没什么难的难的是下载依赖的速度——默认中央仓库在国外国内网络经常慢到让人怀疑人生。解决办法是修改Maven的settings.xml配置文件把镜像换成国内的阿里云仓库mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror这里有一个小白经常踩的坑settings.xml有两个位置——一个是Maven安装目录下的一个是你当前用户目录下的~/.m2/文件夹里的。不要两个都改更不要改完忘了自己改的是哪个。建议记住一个原则改用户目录下的那份优先级更高也不容易影响系统里其他人。配置好后验证一下mvn -v能输出Maven版本和Java版本就说明安装成功。后面IDE里创建项目用的也是这套Maven。2.3 IDEIDEA和VSCode怎么选这是我在带新人时几乎必被问到的问题。我的建议是首选IntelliJ IDEA社区版免费、对Spring Boot支持最好虽然社区版没有Ultimate版那么智能但对学习阶段完全够用。如果你机器性能一般或者更喜欢轻量编辑器选VSCode也行。在VSCode里装好“Extension Pack for Java”和“Spring Boot Extension Pack”两个扩展后新建项目、写Controller、启动调试都能做只是偶尔有些提示不如IDEA全。我自己带过用VSCode跑Spring Boot的同事他能正常开发说明这条路是通的。所以别再问“用VSCode能不能学Spring Boot”了能放心用。2.4 验证环境三步确认能开局装完上面三样别急着写代码先在命令行做一个综合验证java -version mvn -v如果这两条都没问题再检查一下IDE能不能正常识别JDK和Maven。IDEA里打开File → Settings → Build Tools → Maven确认Maven home path指向你安装Maven的目录VSCode里按CtrlShiftP输入Java: Configure Java Runtime确认JDK路径正确。这三步做完你的环境就算过关了。很多人后面项目创建失败八成是这一步没做好——Maven找不到JDK、IDE用了错误的Maven路径等等。3. 创建第一个Spring Boot项目从向导到跑起来3.1 用Spring Initializr生成项目骨架环境就绪后创建项目最省事的办法是用官方提供的Spring Initializr——一个在线的项目生成器你把项目信息填好它打包给你一个可直接导入的工程。访问https://start.spring.io按下面填ProjectMavenLanguageJavaSpring Boot选最新的稳定版本一般带(SNAPSHOT)字样的不要选那是开发版Project MetadataGroup填com.exampleArtifact填demoDependencies先勾选一个Spring Web点“Generate”下载解压后用IDEA或VSCode打开。这里多说一句IDEA的Ultimate版本身就内置了Spring Initializr直接连续点下一步就能生成社区版没有入口推荐用网页版生成的zip导入效果完全一样。3.2 项目结构逐层拆解项目打开后你会看到这样一个结构src/main/java/com/example/demo/DemoApplication.java src/main/resources/application.properties pom.xml很多新人看到这么多文件夹就发怵。其实你只需要搞懂三样东西DemoApplication.java启动类。它里面的main方法负责启动整个Spring Boot应用你在IDE里直接运行它就可以了。application.properties配置文件。端口号、数据库连接等都在这里改。pom.xml项目的依赖清单你后面加新功能比如连数据库就在这里面加依赖。只要这三样懂了项目骨架就算拿下了。剩下的target目录是构建产物不用管src/test是测试目录暂时先忽略。3.3 写第一个接口并启动在启动类所在的包下新建一个类命名HelloControllerpackage com.example.demo; 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!; } }然后运行DemoApplication的main方法。看到控制台输出类似Tomcat started on port 8080的日志打开浏览器访问http://localhost:8080/hello页面上出现Hello, Spring Boot!你的第一个Spring Boot应用就跑通了。这里有几个细节感受建议你留心一下第一你没有装任何Web服务器、没有写一条XML配置但Tomcat已经自动跑起来了第二RestController和GetMapping这两个注解就完成了“声明一个HTTP接口”的全部工作。这就是Spring Boot的魔法接下来我们拆穿它。3.4 换个端口修改server.port很多教程把这个当简单配置一笔带过但实际开发里几乎立刻就能用到——因为8080端口非常容易被其他程序占用比如微信开发者工具、各种本地服务。改端口很简单在application.properties里加一行server.port8081重启应用访问http://localhost:8081/hello就换成功了。如果改了端口还启动失败提示Port 8081 was already in use说明端口被占用了。Windows下可以用netstat -ano | findstr 8081找到占用端口的进程PID然后在任务管理器里结束它或者干脆再换一个不冲突的端口。我建议新人固定用8080或8081别一会儿换一个否则连自己都会记混。4. 跑起来之后拆开看看自动配置和Starter的魔法4.1 Starter一包解千愁的依赖聚合前面说到你只加了一个spring-boot-starter-webTomcat、SpringMVC、JacksonJSON处理就都齐了。要理解发生了什么打开项目里的pom.xml点spring-boot-starter-web那一行IDE会展示出它传递依赖的所有子项。你会发现starter-web不是某一个库而是很多库的清单。它就像网购时的一键下单不用你逐个找商品、比价格、担心配套平台已经帮你组合好了。Spring Boot官方针对不同场景提供了大量Starterspring-boot-starter-test管测试spring-boot-starter-jdbc管数据库mybatis-spring-boot-starter管MyBatis集成。记住这个规律你在pom.xml里加一个Starter就等于给项目加了一类能力。4.2 SpringBootApplication里到底藏了什么回到启动类你看到的是一个叫SpringBootApplication的注解。它在源码层面其实是三个注解的合体SpringBootConfiguration标记这是个配置类EnableAutoConfiguration开启自动配置这是核心ComponentScan扫描当前包及其子包下的组件让你写的HelloController能被框架发现很多人不理解为什么Controller放在别的包就扫描不到答案就在这里——ComponentScan默认只扫描启动类所在的包以及子包。所以你的业务代码一定要放在启动类所在的com.example.demo包下面或者它的子包里否则就算代码写对了也跑不起来。4.3 自动配置是怎么“猜”出你的需求的自动配置是最容易让人困惑的部分。我尝试用人话拆一下当Spring Boot启动时它会检查当前项目的classpath里有哪些jar包。因为你加了starter-webclasspath里就有了Tomcat和SpringMVC的类于是自动配置就会说“哦你要做Web应用那我帮你把Tomcat启动起来把前端控制器注册好把默认的JSON转换器配上。”这个“如果存在某个类就自动装配某功能”的机制在Spring Boot里靠一组条件注解实现比如ConditionalOnClass某个类在classpath里才生效、ConditionalOnMissingBean没有用户自定义的Bean才生效。作为初学者你不需要去读每个自动配置类的源码但需要明白一个关键点自动配置只是默认值不是铁律。它给你的是一套还能用的默认环境当你自己有定制需求时只要在配置文件里写了对应属性或者自己定义了Bean默认配置就会自动退出让位给用户配置。4.4 自定义配置的优先级别被坑了Spring Boot的配置可以写在很多地方命令行参数、application.properties、application.yml、环境变量、外部配置文件。它们的优先级从高到低有严格顺序。平时用得最多的就是项目里的application.properties或application.yml。实际遇到的情况往往是这样的你在application.properties里配了server.port8081但启动时加了命令行参数--server.port8082结果实际端口是8082——因为命令行参数优先级更高。还有更隐蔽的你在IDEA的配置里不小心设置了环境变量SERVER_PORT那环境变量的优先级会盖过你的application.properties。遇到这种“明明改了配置却不生效”的问题别急着怀疑人生按优先级从高到低排查命令行 环境变量 外部配置文件 项目内的application.properties/yml。5. 把数据库接进来Spring Boot MyBatis 的完整链路5.1 为什么我推荐新人选MyBatis而不是JPA做后端开发必然要连数据库。Java世界主流的两个数据库访问方案是Spring Data JPA和MyBatis。很多教程会讲JPA因为它“不用写SQL”。但我更推荐新人先学MyBatis原因非常现实**国内绝大多数公司的Java项目用的是MyBatis或MyBatis-Plus你去看开源商城系统、管理系统基本都是这套。**哪怕只有一个接口和SQL需求MyBatis那套“自己写SQL、心里有数”的思路也远比比“让框架替你拼SQL”更容易排查问题。而且事实上懂MyBatis之后你再去学MyBatis-Plus它对单表CRUD做了封装不用写SQL非常快反而是反过来容易懵。方向别反了。5.2 表结构、实体类、Mapper三层如何协作假设有一张student表字段有id、name、major。在MyBatis的世界里你需要写三个角色实体类对应表中的一行记录public class Student { private Long id; private String name; private String major; // getter和setter省略 }Mapper接口定义你要执行的操作Mapper public interface StudentMapper { ListStudent selectAll(); }Mapper XML文件放在resources/mapper目录下写具体SQL?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.demo.mapper.StudentMapper select idselectAll resultTypecom.example.demo.entity.Student SELECT id, name, major FROM student /select /mapper调用关系是Controller接收前端请求 → 调用StudentService→StudentService调用StudentMapper接口方法 → MyBatis框架根据namespace和id找到XML里对应的SQL执行 → 返回结果。这个链路就是你以后写所有业务的基础。5.3 接上数据库后最容易翻车的三个配置要在Spring Boot里用MyBatis连接MySQLpom.xml要加两个依赖dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version /dependency然后在application.properties里配数据源spring.datasource.urljdbc:mysql://localhost:3306/demo?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai spring.datasource.usernameroot spring.datasource.password123456 mybatis.mapper-locationsclasspath:mapper/*.xml这里有三个翻车点时区问题连接串里不加serverTimezoneAsia/Shanghai大概率会报时区错误。驱动版本名字变化新版本的MySQL驱动是com.mysql.cj.jdbc.Driver老版本是com.mysql.jdbc.Driver如果你还在配置driver-class-name一定要确认自己写的哪个别照着老教程抄。Mapper XML扫描不到mybatis.mapper-locations必须配成classpath:mapper/*.xml而且XML文件必须真实存在于resources/mapper目录下不然启动时会报Invalid bound statement (not found)。5.4 从Mapper到接口的调用链路实例为了让你对整条链路有实感我写一个最简单的查询接口。先定义ServiceService public class StudentService { Resource private StudentMapper studentMapper; public ListStudent listAll() { return studentMapper.selectAll(); } }再改ControllerRestController public class StudentController { Resource private StudentService studentService; GetMapping(/students) public ListStudent list() { return studentService.listAll(); } }启动项目访问http://localhost:8081/students就能看到从MySQL查出来的JSON数据。到这里Spring Boot已经把你从“写接口”带到了“接口数据库”这条标准全栈开发链路上你以后写的任何业务本质上都是这个套路前端请求 → Controller接收 → Service处理逻辑 → Mapper操作数据库 → 返回结果。6. 日常开发必踩的坑与排查端口、热启动、依赖冲突6.1 端口冲突与主动改端口前面提过改端口的事但实际开发里端口问题远比想象中频繁。尤其是做全栈的时候前端比如Vue项目默认跑8080后端Spring Boot也默认跑8080这时候你就得让后端挪位置。我见过不少新人卡在这里手足无措。我的建议是前端项目如果默认8080后端固定用8081从一开始就把这个分工定死可以省掉很多麻烦。改完端口后访问接口路径时记得带上新端口号就行比如http://localhost:8081/hello。6.2 改代码不用重启devtools热更新每次改一行代码重启一次应用开发久了真的会崩溃。Spring Boot提供了spring-boot-devtools这个依赖加了它之后只要IDE里触发热编译应用会自动重启是重启不是像前端那样的热替换。在pom.xml里加dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-devtools/artifactId optionaltrue/optional /dependency用IDEA的话要确认Build project automatically选项打开了否则不会自动重启。VSCode下用Spring Boot插件同理。但注意devtools只适合开发阶段。它会让应用的类加载器和正常模式不一样如果你后面打jar包部署到服务器这个依赖要么排除掉要么确保不影响生产。新人常犯的错是把devtools发到了生产环境导致应用行为异常。6.3 启动失败别慌按这套顺序排查项目一多启动失败就是家常便饭。出现红色报错第一件事不是去百度而是按顺序自查看日志第一行错误Spring Boot的报错信息一般很长但真正的根因往往在最底下Caused by部分。往上翻找到第一个Caused by那才是病根。检查端口占用如果提示Port already in use按前面说的方法解决。检查数据源配置如果提示Failed to configure a DataSource说明你加了数据库相关依赖但没配连接信息或者配置里用户名密码错了。检查Mapper绑定如果提示Invalid bound statement (not found)去确认mybatis.mapper-locations路径和XML文件名。这四步能解决我遇到的九成启动问题。新人最容易犯的错是看到报错就慌把一长串日志全部贴到群里问其实根因就是几十行里的一行。6.4 依赖冲突最隐蔽的坑Spring Boot虽然已经帮你处理了大多数依赖版本问题但还是会有意外。最典型的是日志框架冲突项目里既有Logback又有Log4j2或者直接用到一个依赖间接带入了旧版的log4j启动时会出现SLF4J: Class path contains multiple SLF4J bindings警告严重的时候直接报错。解决思路永远是“先找到是谁引入的重复依赖”在IDEA里打开pom.xml点击右上角的Maven工具窗口用Show Dependencies查看依赖树按CtrlF搜索那个冲突的jar包找到它之后的处理方式是在对应的依赖里加exclusions排除掉。这个技能等你项目做大了之后一定会用到建议提前了解一下不要等到线上炸了再学。7. 接下来怎么学从跑通到全栈实战到这里你已经走完了“环境搭建 → 创建项目 → 写接口 → 连数据库 → 排查问题”这条最完整的学习路径。但我知道看完文章和真正上手之间还有一段距离。根据我带人的经验下一步你应该做三件事第一把文章里的例子从头到尾自己敲一遍不要复制粘贴。哪怕慢哪怕报错都要自己敲因为报错处理本身就是最值钱的学习过程。第二找一个真实的小系统来练手。比如做一个“大学生就业推荐系统”的简单版本学生表、企业表、投递记录表用你刚学会的Spring Boot MyBatis管理后端前端哪怕只用最简单的Vue或HTML都行。这个小项目做完你等于完成了从“认识Spring Boot”到“能做全栈”的蜕变。第三去看一个完整的、非玩具级的开源项目源码比如那种基于Spring Boot的多商户商城项目、电商系统。看的时候不理全部只看代码结构启动类怎么写的、配置文件有哪些、Controller和Service怎么分层、守卫接口的登录校验在哪里。当你发现自己对着别人的项目不再发懵、能找到入口的时候恭喜你你已经不是小白的水平了。我在实际带人过程中发现整个过程最快的记录是两周跑到数据库最慢的也就是多看几遍这篇文章、多敲几遍代码的事。Spring Boot的进阶空间很大微服务、分布式、消息队列都在后面等着但起步阶段真的不该被吓住。把开头那个HelloWorld跑起来你就已经赢了大多数人。最后再分享一个小技巧遇到任何看不懂的报错先把英文日志复制到搜索引擎里搜不要用中文翻译后的说法搜——你会发现用英文原文搜出来的答案质量和数量完全不是一个量级。这是搞Java开发的基本功也是你接下来每一次“踩坑爬坑”里最可靠的助手。
我最近在带几个完全零基础的同事转Java方向发现一个很普遍的现象大家一说学Spring Boot第一反应就是去搜“SSM框架教程”然后从Spring的IOC容器、Bean生命周期开始啃啃了两个星期连一个能跑的HelloWorld都没写出来。这种学法其实完全反了——Spring Boot之所以叫Boot就是因为它把“启动”这件事的门槛降到了最低。你不需要先搞懂底层一堆设计模式也能把项目跑起来而全栈开发入门最需要的恰恰就是“先把东西跑起来”的正反馈。这篇文章就是写给编程小白看的Spring Boot入门指南。我会尽量把每一个概念都讲成人话每一步都给出可以直接照抄的操作同时把那些网上教程通常不会写、但实际开发中一定会遇到的细节和坑一并塞给你。不管你是刚毕业的学生、想转行的非科班还是已经会一点Java但被Spring全家桶劝退过的人跟着这篇文章走一遍你就能拥有一个真正属于自己的全栈项目地基。1. 学Spring Boot之前先把“它到底解决了什么”想清楚1.1 在Spring Boot之前SSH/SSM那套配置有多折腾很多新人看老教程会一脸懵为什么以前的Spring项目里会有那么多applicationContext.xml、springmvc-servlet.xml、web.xml为什么引入一个依赖还要自己去下载jar包、处理版本冲突为什么部署的时候要把项目打成war包再塞进Tomcat这些问题的根源在于早期的Java Web开发——也就是常说的SSHStruts2 Spring Hibernate或SSMSpring SpringMVC MyBatis——把大量精力浪费在了“配置”而不是“业务”上。我当时照着教程搭一个HelloWorld光配置文件就写了上百行还经常因为某个jar包版本对不上而启动报错一调就是一下午。这种体验对零基础的人来说基本等于劝退。Spring Boot的诞生就是为了终结这种“配置地狱”。它把“搭建项目”这件事从“手动拼装一堆零件”变成了“选好套餐直接开车”。1.2 用生活类比理解三个核心设计要理解Spring Boot先记住三个词约定优于配置、Starter依赖、独立运行。约定优于配置好比你去宜家买家具说明书告诉你“螺丝A拧进孔B”你照着做就行不需要自己去设计哪颗螺丝该拧在哪。Spring Boot规定了一套默认的项目结构、默认的配置文件名、默认的端口号你只要遵循这个约定框架就自动帮你把环境搭好。Starter依赖好比你去餐厅点“一人食套餐”而不是分别去买米、买菜、买调料再自己做。比如你想开发Web接口只需要引入spring-boot-starter-web这一个依赖它会把SpringMVC、内嵌Tomcat、JSON处理工具等一系列必要依赖一次性打包给你互相之间版本还已经帮你调好了。独立运行Spring Boot应用内部内置了Tomcat等Web服务器所以你可以像运行普通Java程序一样直接跑起来不需要单独安装Tomcat、配置部署目录。这在开发和部署时的省心程度用过的人都知道。1.3 “全栈开发”里Spring Boot到底占哪一层常有人问我全栈开发是不是就是“前端后端”都会是但不完整。一个合格的全栈项目至少包含前端页面、后端接口、数据库设计、部署运维四个部分。Spring Boot负责的是其中最核心的后端接口层——它接收前端过来的HTTP请求处理业务逻辑读写数据库再把结果返回给前端。所以我建议你把Spring Boot理解成“整个项目的中枢”。前端可以随便换Vue、React甚至小程序数据库也可以换MySQL、PostgreSQL只要后端接口是Spring Boot提供的整个系统转起来就非常顺畅。这也是为什么很多开源项目比如各种电商商城系统、就业推荐系统的后端都选它。2. 环境准备JDK、Maven、IDE三件套怎么选、怎么验2.1 JDK到底选哪个版本先说结论如果你是新学直接装JDK 17LTS长期支持版本。别纠结别选JDK 8也别追JDK 21。原因很简单JDK 8太老很多新特性不支持JDK 17是目前Spring Boot 3.x的默认基线网上最新的教程和开源项目基本都在用它遇到问题搜资料也最好搜。安装JDK之后一定要在命令行里确认环境变量配置成功java -version javac -version看到版本号输出还不算完再敲一句echo $JAVA_HOMEWindows用户敲echo %JAVA_HOME%。如果输出为空说明JAVA_HOME没配好很多工具后面要用的Maven会找不到Java。这里特别提醒一句环境变量里配JAVA_HOME的路径一定要指到JDK安装目录的上一级而不是bin目录比如C:\Program Files\Java\jdk-17不是C:\Program Files\Java\jdk-17\bin。2.2 Maven别急着配服务器先搞懂镜像Maven是Java项目的依赖管理和构建工具。它的作用通俗讲就是你告诉它“我要用MySQL驱动”它自动去仓库下载jar包并管理版本。安装Maven没什么难的难的是下载依赖的速度——默认中央仓库在国外国内网络经常慢到让人怀疑人生。解决办法是修改Maven的settings.xml配置文件把镜像换成国内的阿里云仓库mirror idaliyunmaven/id mirrorOfcentral/mirrorOf name阿里云公共仓库/name urlhttps://maven.aliyun.com/repository/public/url /mirror这里有一个小白经常踩的坑settings.xml有两个位置——一个是Maven安装目录下的一个是你当前用户目录下的~/.m2/文件夹里的。不要两个都改更不要改完忘了自己改的是哪个。建议记住一个原则改用户目录下的那份优先级更高也不容易影响系统里其他人。配置好后验证一下mvn -v能输出Maven版本和Java版本就说明安装成功。后面IDE里创建项目用的也是这套Maven。2.3 IDEIDEA和VSCode怎么选这是我在带新人时几乎必被问到的问题。我的建议是首选IntelliJ IDEA社区版免费、对Spring Boot支持最好虽然社区版没有Ultimate版那么智能但对学习阶段完全够用。如果你机器性能一般或者更喜欢轻量编辑器选VSCode也行。在VSCode里装好“Extension Pack for Java”和“Spring Boot Extension Pack”两个扩展后新建项目、写Controller、启动调试都能做只是偶尔有些提示不如IDEA全。我自己带过用VSCode跑Spring Boot的同事他能正常开发说明这条路是通的。所以别再问“用VSCode能不能学Spring Boot”了能放心用。2.4 验证环境三步确认能开局装完上面三样别急着写代码先在命令行做一个综合验证java -version mvn -v如果这两条都没问题再检查一下IDE能不能正常识别JDK和Maven。IDEA里打开File → Settings → Build Tools → Maven确认Maven home path指向你安装Maven的目录VSCode里按CtrlShiftP输入Java: Configure Java Runtime确认JDK路径正确。这三步做完你的环境就算过关了。很多人后面项目创建失败八成是这一步没做好——Maven找不到JDK、IDE用了错误的Maven路径等等。3. 创建第一个Spring Boot项目从向导到跑起来3.1 用Spring Initializr生成项目骨架环境就绪后创建项目最省事的办法是用官方提供的Spring Initializr——一个在线的项目生成器你把项目信息填好它打包给你一个可直接导入的工程。访问https://start.spring.io按下面填ProjectMavenLanguageJavaSpring Boot选最新的稳定版本一般带(SNAPSHOT)字样的不要选那是开发版Project MetadataGroup填com.exampleArtifact填demoDependencies先勾选一个Spring Web点“Generate”下载解压后用IDEA或VSCode打开。这里多说一句IDEA的Ultimate版本身就内置了Spring Initializr直接连续点下一步就能生成社区版没有入口推荐用网页版生成的zip导入效果完全一样。3.2 项目结构逐层拆解项目打开后你会看到这样一个结构src/main/java/com/example/demo/DemoApplication.java src/main/resources/application.properties pom.xml很多新人看到这么多文件夹就发怵。其实你只需要搞懂三样东西DemoApplication.java启动类。它里面的main方法负责启动整个Spring Boot应用你在IDE里直接运行它就可以了。application.properties配置文件。端口号、数据库连接等都在这里改。pom.xml项目的依赖清单你后面加新功能比如连数据库就在这里面加依赖。只要这三样懂了项目骨架就算拿下了。剩下的target目录是构建产物不用管src/test是测试目录暂时先忽略。3.3 写第一个接口并启动在启动类所在的包下新建一个类命名HelloControllerpackage com.example.demo; 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!; } }然后运行DemoApplication的main方法。看到控制台输出类似Tomcat started on port 8080的日志打开浏览器访问http://localhost:8080/hello页面上出现Hello, Spring Boot!你的第一个Spring Boot应用就跑通了。这里有几个细节感受建议你留心一下第一你没有装任何Web服务器、没有写一条XML配置但Tomcat已经自动跑起来了第二RestController和GetMapping这两个注解就完成了“声明一个HTTP接口”的全部工作。这就是Spring Boot的魔法接下来我们拆穿它。3.4 换个端口修改server.port很多教程把这个当简单配置一笔带过但实际开发里几乎立刻就能用到——因为8080端口非常容易被其他程序占用比如微信开发者工具、各种本地服务。改端口很简单在application.properties里加一行server.port8081重启应用访问http://localhost:8081/hello就换成功了。如果改了端口还启动失败提示Port 8081 was already in use说明端口被占用了。Windows下可以用netstat -ano | findstr 8081找到占用端口的进程PID然后在任务管理器里结束它或者干脆再换一个不冲突的端口。我建议新人固定用8080或8081别一会儿换一个否则连自己都会记混。4. 跑起来之后拆开看看自动配置和Starter的魔法4.1 Starter一包解千愁的依赖聚合前面说到你只加了一个spring-boot-starter-webTomcat、SpringMVC、JacksonJSON处理就都齐了。要理解发生了什么打开项目里的pom.xml点spring-boot-starter-web那一行IDE会展示出它传递依赖的所有子项。你会发现starter-web不是某一个库而是很多库的清单。它就像网购时的一键下单不用你逐个找商品、比价格、担心配套平台已经帮你组合好了。Spring Boot官方针对不同场景提供了大量Starterspring-boot-starter-test管测试spring-boot-starter-jdbc管数据库mybatis-spring-boot-starter管MyBatis集成。记住这个规律你在pom.xml里加一个Starter就等于给项目加了一类能力。4.2 SpringBootApplication里到底藏了什么回到启动类你看到的是一个叫SpringBootApplication的注解。它在源码层面其实是三个注解的合体SpringBootConfiguration标记这是个配置类EnableAutoConfiguration开启自动配置这是核心ComponentScan扫描当前包及其子包下的组件让你写的HelloController能被框架发现很多人不理解为什么Controller放在别的包就扫描不到答案就在这里——ComponentScan默认只扫描启动类所在的包以及子包。所以你的业务代码一定要放在启动类所在的com.example.demo包下面或者它的子包里否则就算代码写对了也跑不起来。4.3 自动配置是怎么“猜”出你的需求的自动配置是最容易让人困惑的部分。我尝试用人话拆一下当Spring Boot启动时它会检查当前项目的classpath里有哪些jar包。因为你加了starter-webclasspath里就有了Tomcat和SpringMVC的类于是自动配置就会说“哦你要做Web应用那我帮你把Tomcat启动起来把前端控制器注册好把默认的JSON转换器配上。”这个“如果存在某个类就自动装配某功能”的机制在Spring Boot里靠一组条件注解实现比如ConditionalOnClass某个类在classpath里才生效、ConditionalOnMissingBean没有用户自定义的Bean才生效。作为初学者你不需要去读每个自动配置类的源码但需要明白一个关键点自动配置只是默认值不是铁律。它给你的是一套还能用的默认环境当你自己有定制需求时只要在配置文件里写了对应属性或者自己定义了Bean默认配置就会自动退出让位给用户配置。4.4 自定义配置的优先级别被坑了Spring Boot的配置可以写在很多地方命令行参数、application.properties、application.yml、环境变量、外部配置文件。它们的优先级从高到低有严格顺序。平时用得最多的就是项目里的application.properties或application.yml。实际遇到的情况往往是这样的你在application.properties里配了server.port8081但启动时加了命令行参数--server.port8082结果实际端口是8082——因为命令行参数优先级更高。还有更隐蔽的你在IDEA的配置里不小心设置了环境变量SERVER_PORT那环境变量的优先级会盖过你的application.properties。遇到这种“明明改了配置却不生效”的问题别急着怀疑人生按优先级从高到低排查命令行 环境变量 外部配置文件 项目内的application.properties/yml。5. 把数据库接进来Spring Boot MyBatis 的完整链路5.1 为什么我推荐新人选MyBatis而不是JPA做后端开发必然要连数据库。Java世界主流的两个数据库访问方案是Spring Data JPA和MyBatis。很多教程会讲JPA因为它“不用写SQL”。但我更推荐新人先学MyBatis原因非常现实**国内绝大多数公司的Java项目用的是MyBatis或MyBatis-Plus你去看开源商城系统、管理系统基本都是这套。**哪怕只有一个接口和SQL需求MyBatis那套“自己写SQL、心里有数”的思路也远比比“让框架替你拼SQL”更容易排查问题。而且事实上懂MyBatis之后你再去学MyBatis-Plus它对单表CRUD做了封装不用写SQL非常快反而是反过来容易懵。方向别反了。5.2 表结构、实体类、Mapper三层如何协作假设有一张student表字段有id、name、major。在MyBatis的世界里你需要写三个角色实体类对应表中的一行记录public class Student { private Long id; private String name; private String major; // getter和setter省略 }Mapper接口定义你要执行的操作Mapper public interface StudentMapper { ListStudent selectAll(); }Mapper XML文件放在resources/mapper目录下写具体SQL?xml version1.0 encodingUTF-8? !DOCTYPE mapper PUBLIC -//mybatis.org//DTD Mapper 3.0//EN http://mybatis.org/dtd/mybatis-3-mapper.dtd mapper namespacecom.example.demo.mapper.StudentMapper select idselectAll resultTypecom.example.demo.entity.Student SELECT id, name, major FROM student /select /mapper调用关系是Controller接收前端请求 → 调用StudentService→StudentService调用StudentMapper接口方法 → MyBatis框架根据namespace和id找到XML里对应的SQL执行 → 返回结果。这个链路就是你以后写所有业务的基础。5.3 接上数据库后最容易翻车的三个配置要在Spring Boot里用MyBatis连接MySQLpom.xml要加两个依赖dependency groupIdcom.mysql/groupId artifactIdmysql-connector-j/artifactId scoperuntime/scope /dependency dependency groupIdorg.mybatis.spring.boot/groupId artifactIdmybatis-spring-boot-starter/artifactId version3.0.3/version /dependency然后在application.properties里配数据源spring.datasource.urljdbc:mysql://localhost:3306/demo?useUnicodetruecharacterEncodingutf8serverTimezoneAsia/Shanghai spring.datasource.usernameroot spring.datasource.password123456 mybatis.mapper-locationsclasspath:mapper/*.xml这里有三个翻车点时区问题连接串里不加serverTimezoneAsia/Shanghai大概率会报时区错误。驱动版本名字变化新版本的MySQL驱动是com.mysql.cj.jdbc.Driver老版本是com.mysql.jdbc.Driver如果你还在配置driver-class-name一定要确认自己写的哪个别照着老教程抄。Mapper XML扫描不到mybatis.mapper-locations必须配成classpath:mapper/*.xml而且XML文件必须真实存在于resources/mapper目录下不然启动时会报Invalid bound statement (not found)。5.4 从Mapper到接口的调用链路实例为了让你对整条链路有实感我写一个最简单的查询接口。先定义ServiceService public class StudentService { Resource private StudentMapper studentMapper; public ListStudent listAll() { return studentMapper.selectAll(); } }再改ControllerRestController public class StudentController { Resource private StudentService studentService; GetMapping(/students) public ListStudent list() { return studentService.listAll(); } }启动项目访问http://localhost:8081/students就能看到从MySQL查出来的JSON数据。到这里Spring Boot已经把你从“写接口”带到了“接口数据库”这条标准全栈开发链路上你以后写的任何业务本质上都是这个套路前端请求 → Controller接收 → Service处理逻辑 → Mapper操作数据库 → 返回结果。6. 日常开发必踩的坑与排查端口、热启动、依赖冲突6.1 端口冲突与主动改端口前面提过改端口的事但实际开发里端口问题远比想象中频繁。尤其是做全栈的时候前端比如Vue项目默认跑8080后端Spring Boot也默认跑8080这时候你就得让后端挪位置。我见过不少新人卡在这里手足无措。我的建议是前端项目如果默认8080后端固定用8081从一开始就把这个分工定死可以省掉很多麻烦。改完端口后访问接口路径时记得带上新端口号就行比如http://localhost:8081/hello。6.2 改代码不用重启devtools热更新每次改一行代码重启一次应用开发久了真的会崩溃。Spring Boot提供了spring-boot-devtools这个依赖加了它之后只要IDE里触发热编译应用会自动重启是重启不是像前端那样的热替换。在pom.xml里加dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-devtools/artifactId optionaltrue/optional /dependency用IDEA的话要确认Build project automatically选项打开了否则不会自动重启。VSCode下用Spring Boot插件同理。但注意devtools只适合开发阶段。它会让应用的类加载器和正常模式不一样如果你后面打jar包部署到服务器这个依赖要么排除掉要么确保不影响生产。新人常犯的错是把devtools发到了生产环境导致应用行为异常。6.3 启动失败别慌按这套顺序排查项目一多启动失败就是家常便饭。出现红色报错第一件事不是去百度而是按顺序自查看日志第一行错误Spring Boot的报错信息一般很长但真正的根因往往在最底下Caused by部分。往上翻找到第一个Caused by那才是病根。检查端口占用如果提示Port already in use按前面说的方法解决。检查数据源配置如果提示Failed to configure a DataSource说明你加了数据库相关依赖但没配连接信息或者配置里用户名密码错了。检查Mapper绑定如果提示Invalid bound statement (not found)去确认mybatis.mapper-locations路径和XML文件名。这四步能解决我遇到的九成启动问题。新人最容易犯的错是看到报错就慌把一长串日志全部贴到群里问其实根因就是几十行里的一行。6.4 依赖冲突最隐蔽的坑Spring Boot虽然已经帮你处理了大多数依赖版本问题但还是会有意外。最典型的是日志框架冲突项目里既有Logback又有Log4j2或者直接用到一个依赖间接带入了旧版的log4j启动时会出现SLF4J: Class path contains multiple SLF4J bindings警告严重的时候直接报错。解决思路永远是“先找到是谁引入的重复依赖”在IDEA里打开pom.xml点击右上角的Maven工具窗口用Show Dependencies查看依赖树按CtrlF搜索那个冲突的jar包找到它之后的处理方式是在对应的依赖里加exclusions排除掉。这个技能等你项目做大了之后一定会用到建议提前了解一下不要等到线上炸了再学。7. 接下来怎么学从跑通到全栈实战到这里你已经走完了“环境搭建 → 创建项目 → 写接口 → 连数据库 → 排查问题”这条最完整的学习路径。但我知道看完文章和真正上手之间还有一段距离。根据我带人的经验下一步你应该做三件事第一把文章里的例子从头到尾自己敲一遍不要复制粘贴。哪怕慢哪怕报错都要自己敲因为报错处理本身就是最值钱的学习过程。第二找一个真实的小系统来练手。比如做一个“大学生就业推荐系统”的简单版本学生表、企业表、投递记录表用你刚学会的Spring Boot MyBatis管理后端前端哪怕只用最简单的Vue或HTML都行。这个小项目做完你等于完成了从“认识Spring Boot”到“能做全栈”的蜕变。第三去看一个完整的、非玩具级的开源项目源码比如那种基于Spring Boot的多商户商城项目、电商系统。看的时候不理全部只看代码结构启动类怎么写的、配置文件有哪些、Controller和Service怎么分层、守卫接口的登录校验在哪里。当你发现自己对着别人的项目不再发懵、能找到入口的时候恭喜你你已经不是小白的水平了。我在实际带人过程中发现整个过程最快的记录是两周跑到数据库最慢的也就是多看几遍这篇文章、多敲几遍代码的事。Spring Boot的进阶空间很大微服务、分布式、消息队列都在后面等着但起步阶段真的不该被吓住。把开头那个HelloWorld跑起来你就已经赢了大多数人。最后再分享一个小技巧遇到任何看不懂的报错先把英文日志复制到搜索引擎里搜不要用中文翻译后的说法搜——你会发现用英文原文搜出来的答案质量和数量完全不是一个量级。这是搞Java开发的基本功也是你接下来每一次“踩坑爬坑”里最可靠的助手。
