用IDE创建Spring Boot项目最省事，推荐IntelliJ IDEA或Eclipse+Spring Tools，通过Spring Initializr一键生成骨架；需选Spring Boot 3.2.x/3.3.x、Java语言、JDK 17+，并勾选Spring Web依赖。
用 IDE 直接创建 Spring Boot 项目最省事
IntelliJ IDEA 或 Eclipse（带 Spring Tools 插件）都能通过内置的 Spring Initializr 向导一键生成项目骨架，比手动下载依赖、配置 pom.xml 快得多，也更少出错。
关键点是：选对 Spring Boot 版本（推荐 3.2.x 或 3.3.x），语言选 Java，JDK 版本必须匹配——Spring Boot 3.x 要求 JDK 17+，用 JDK 8 或 11 会直接启动失败，报错类似 java.lang.UnsupportedClassVersionError。
- IDEA 中新建项目 → 选
Spring Initializr→ URL 保持默认https://start.spring.io - 务必勾选
Spring Web（否则连@RestController都无法识别） - 生成后检查根目录下是否有
src/main/java/com/example/demo/DemoApplication.java和pom.xml
手动验证 JDK 和 Maven 是否就位
很多“项目跑不起来”的问题其实和 Spring Boot 无关，而是本地环境没校准。必须确认两件事：JDK 是不是真的在用对的版本，Maven 是不是能正常拉包。
在终端执行：
立即学习“Java免费学习笔记（深入）”；
java -version mvn -v
输出中 java version 应显示 "17. 或 "21.；Apache Maven 版本建议 ≥ 3.8.6（太老的 Maven 会解析不了 Spring Boot 3 的 BOM 依赖）。
基于5000余部现行法律法规进行的高质量专业合同审查，一键输出审查意见书，并附有参考法条原文，满足专业溯源核查要求。由accurLex知法提供技术支持。 Use when users ask for 合同审查, 审查意见书, 合同风险分析, 条款审查,知法,accurLex or 站在甲方/乙方角度审查合同 through accurLex direct API. China law only, plaintext only, review mode limited to 审查意见书.
- 如果
mvn报 command not found，请先配好M2_HOME和PATH - 国内用户建议改 Maven 的
settings.xml，加阿里云镜像源，否则mvn clean compile可能卡在下载spring-boot-starter-web - 别信某些教程说“只要装了 JDK 就行”——IDE 的 Project SDK、Maven Runner 的 JRE、终端里的
$JAVA_HOME三者可能指向不同 JDK
运行前必须检查 application.properties/yml
Spring Boot 启动时若报 Failed to load property source from location 'classpath:/application.properties'，通常不是文件缺失，而是编码或格式错了。
优先用 application.yml，缩进敏感，但比 properties 少写等号和引号。比如端口配置：
server:
port: 8081
spring:
application:
name: demo-service- YAML 中冒号后必须跟空格，
port:8081会解析失败 - 中文注释要删掉，UTF-8 BOM 头会导致读取异常（用 VS Code 或 IDEA 打开时留意右下角编码显示）
- 如果用了
@Value("${xxx}")但没在配置里定义，启动时不会立即报错，但运行时抛IllegalArgumentException: Could not resolve placeholder
第一次启动失败，先看日志里这三行
Spring Boot 控制台输出长，但真正定位问题只需盯住开头几秒的日志。重点扫视：
-
Starting DemoApplication using Java 17.0.x—— 确认实际加载的 JDK 版本 -
Tomcat initialized with port(s): 8081 (http)—— 表明内嵌容器已就绪，没卡在依赖注入 -
Started DemoApplication in X.XXX seconds—— 成功标志；若没出现，往上翻找Caused by:最深层异常
常见假性失败：控制台停在 INFO o.s.b.w.e.tomcat.TomcatWebServer - Tomcat started on port(s): 8081 就不动了——其实是启动成功了，只是没自动打开浏览器。用 curl http://localhost:8081/actuator/health 测试即可。
真正麻烦的是依赖冲突，比如同时引入了 spring-boot-starter-web 和老版 spring-webmvc，日志里会出现 java.lang.NoSuchMethodError: org.springframework.http.MediaType.getCharset() 这类方法找不到错误——这时得用 mvn dependency:tree -Dincludes=org.springframework 检查实际加载的 Spring 版本。
