新手应直接运行可部署的Spring Boot项目，推荐spring-petclinic等三个持续维护仓库，并注意JDK 17+、正确配置pom.xml和application.properties以避免启动失败。
新手直接跑通一个可部署的 Java Web 项目，比看十篇概念文档都管用；但网上标着“适合新手”的源码，很多要么缺 pom.xml 依赖配置，要么用的是已停更的 Struts2 或过时的 Servlet 2.5，本地一启动就报 java.lang.ClassNotFoundException: javax.servlet.http.HttpServlet。
GitHub 上真正能跑起来的 Spring Boot 入门项目
认准三个特征：有 mvn spring-boot:run 能直接启动、application.properties 里没硬编码数据库密码、首页是纯 HTML 或 Thymeleaf 渲染（不是 JSP）。推荐这几个持续维护的仓库：
-
spring-projects/spring-petclinic：官方出品，Spring Boot 3.x + Jakarta EE 9+，含 H2 内存库，mvn后访问http://localhost:8080即见完整 CRUD 界面 -
codecentric/spring-boot-admin的spring-boot-admin-sample-app模块：极简监控后台，只有 3 个 Controller，@RestController返回 JSON，适合理解 REST 接口怎么写 -
howtodoinjava/spring-boot-crud-rest-api-example：无前端，纯后端 REST API，curl -X POST就能测试，Postman导入collection.json三步走完增删改查
避开 Maven 依赖地狱：只改 pom.xml 这三处
新手常把别人项目 clone 下来却启动失败，90% 出在依赖版本冲突。别碰 <parent> 整块继承，手动锁定关键坐标：
<properties>
<java.version>17</java.version>
<spring-boot.version>3.2.6</spring-boot.version>
</properties>
<dependencyManagement>
<dependencies>
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-dependencies</artifactId>
<version>${spring-boot.version}</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
如果项目用 MyBatis，删掉所有 mybatis-spring-boot-starter 以外的 mybatis* 依赖；JPA 项目同理，只留 spring-boot-starter-data-jpa，别加 hibernate-core。
立即学习“Java免费学习笔记（深入）”；
Tomcat 启动失败？先检查 src/main/resources/application.properties
Spring Boot 默认内嵌 Tomcat，但新手常误删 spring-boot-starter-web，或在 application.properties 里写了：server.servlet.context-path=/api 却忘了前端请求路径也要同步改，导致所有接口 404。常见配置组合：
- 开发调试：保留
server.port=8080，删掉server.servlet.context-path（即根路径为/） - 连本地 MySQL：确保
spring.datasource.url=jdbc:mysql://localhost:3306/test?serverTimezone=UTC，且已创建test库 - 跳过 HTTPS 强制重定向：删掉
server.ssl.*所有行，或注释掉@Bean SecurityFilterChain中的.requiresChannel().requiresSecure()
最易被忽略的是 JDK 版本和编译级别不匹配——Spring Boot 3.x 要求 JDK 17+，但 IDEA 默认新建项目用的是 JDK 8，mvn compile 会卡在 Unsupported class file major version 61。打开 Project Structure → Project → SDK 和 Language level 必须都是 17。
