必须使用JDK 17或21并手动配置IDEA的Project SDK，通过内置Initializr创建仅含Spring Web依赖的项目，配合阿里云镜像源或关闭代理解决依赖下载问题，最后编写HelloController验证服务成功启动。
想用Spring Boot跑通第一个“Hello World”却卡在JDK版本不匹配、依赖下载失败或启动报错？这不是你一个人的问题——很多新手在创建项目时根本没意识到IDEA默认用的JDK和系统环境变量不一致，或者盲目勾选一堆依赖导致自动配置冲突。
确认并锁定JDK版本
打开终端，执行 java -version，确保输出是 【JDK 17 或 JDK 21】；Spring Boot 3.x 不支持 JDK 8，而 Spring Boot 2.7.x 在 JDK 17 下可能触发部分弃用警告。
启动 IntelliJ IDEA → File → Project Structure → Project → SDK：必须手动选择你本地安装的 JDK 目录（例如 C:\Program Files\Java\jdk-17.0.2），不能留空或选“Project SDK: none”。
这一步漏掉，后续所有依赖都能下载成功，但运行时会直接抛出 Unsupported class file major version 61 这类错误——它不是代码问题，而是字节码版本硬性不兼容。
用 IDEA 内置 Initializr 创建项目
File → New → Project → 左侧选 Spring Initializr → 右侧检查 Type 是否为 Maven，Language 为 Java，Spring Boot 版本选 【3.3.6（当前最新稳定版）】。
点击 Next，在 Dependencies 搜索框输入 web，只勾选 Spring Web ——这是唯一必需项。其他如 Lombok、Actuator、Thymeleaf 全部不勾，避免首次启动因自动配置未就绪而卡死。
填完 Artifact 和 Package name 后点击 Create，等待右下角 Maven 窗口停止滚动、不再显示“Resolving dependencies…”即可。如果卡住超过3分钟，先别刷新，直接看下一步。
解决依赖下载失败的三种应急路径
方法一：换国内镜像源（推荐）
打开 IDEA → Settings → Build, Execution, Deployment → Build Tools → Maven → User settings file，点击右侧“+”号，把以下内容粘贴进新创建的 settings.xml 文件中：
<mirrors>
<mirror>
<id>aliyun</id>
<mirrorOf>central</mirrorOf>
<name>Aliyun Maven</name>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
方法二：关掉代理软件
如果你开了 Clash、Surge 或其他全局代理，IDEA 的 Maven 会尝试走代理连中央仓库，结果超时失败。临时关闭代理再试一次，比改配置更快。
方法三：手动下载 starter 包（兜底）
访问 https://www.php.cn/link/aa119b85a393d57b578950a6bf484494，下载 spring-boot-starter-web-3.3.6.jar 和 spring-boot-starter-web-3.3.6.pom，放入本地 Maven 仓库对应路径：~/.m2/repository/org/springframework/boot/spring-boot-starter-web/3.3.6/，然后在 IDEA 中点击 Maven 工具栏的刷新按钮。
写一个能立刻验证的 Controller
第一步：在 src/main/java 下找到以 Application 结尾的主类（例如 DemoApplication.java），右键 → New → Java Class，命名为 HelloController。
第二步：粘贴以下代码，注意替换包名前缀（比如你的 Group 是 com.example，就保持 package com.example.demo; 不变）：
@RestController<br>public class HelloController {<br> @GetMapping("/hello")<br> public String sayHello() {<br> return "Hello Spring Boot!";<br> }<br>}
第三步：回到主类，点击左侧绿色三角形 ▶️ 运行。控制台出现 Tomcat started on port(s): 8080 并停在最后一行，说明服务已就绪。
第四步：打开浏览器，访问 http://localhost:8080/hello。页面显示纯文本 Hello Spring Boot!，即表示项目搭建完成且运行正常。
