Spring Boot框架安装与配置全攻略【新手必看】

千晨君_9245

千晨君_9245

2026-08-05

214人浏览

原创

spring boot开发需先配置jdk 17、maven(换阿里云镜像)和idea,新建项目时选spring web依赖,启动后访问localhost:8080/hello验证成功。

spring boot框架安装与配置全攻略【新手必看】 - php中文网

想用Java快速开发一个能直接运行的Web服务,又不想被XML配置、依赖冲突和服务器部署卡住?Spring Boot就是为你省掉这些麻烦的框架,但第一步得把环境搭稳——JDK、IDE、Maven三者缺一不可,任意一个配错,新建项目时就会卡在“Loading dependencies…”不动。

安装并配置JDK 17(推荐清华镜像免安装版)

Spring Boot 3.x 要求 JDK 17+,别用JDK 8硬凑,否则创建项目时会报错“No compatible JDK found”。

访问清华镜像站:https://mirrors.tuna.tsinghua.edu.cn/Adoptium/ → 进入 17/jdk/x64/ 目录 → 下载 jdk-17_windows-x64_bin.zip(Windows)或对应 macOS/Linux 版本。

解压到固定路径,例如 D:\Java\jdk-17,**不要放在中文路径或桌面**,否则IDEA识别JDK时可能报错“Invalid path”。

以管理员身份打开 PowerShell,依次执行:

[System.Environment]::SetEnvironmentVariable("JAVA_HOME","D:\Java\jdk-17","Machine")
$currentPath = [System.Environment]::GetEnvironmentVariable("Path","Machine")
$newPath = $currentPath + ";D:\Java\jdk-17\bin"
[System.Environment]::SetEnvironmentVariable("Path",$newPath,"Machine")

关闭并重新打开 PowerShell,运行 java -version,看到输出 java version "17.0.x" 即成功。这一步漏掉或路径写错,后续所有步骤都会失败。

配置Maven并换阿里云镜像(加速依赖下载)

IntelliJ IDEA 自带的Maven版本老旧且默认走国外中央仓库,不换镜像的话,新建Spring Boot项目时可能卡住半小时甚至失败。

方法一:下载并解压 Apache Maven 3.9.x 到 D:\Tools\apache-maven-3.9.0,新建系统变量 【MAVEN_HOME = D:\Tools\apache-maven-3.9.0】,再把 %MAVEN_HOME%\bin 加进 Path。

方法二:直接用 IDEA 内置 Maven(仅限快速验证),但正式开发务必用独立安装版——因为内置版无法修改 settings.xml,镜像配置就落空了。

打开 D:\Tools\apache-maven-3.9.0\conf\settings.xml,找到 标签,在其中插入以下内容:


alimaven
central
aliyun maven
https://maven.aliyun.com/nexus/content/repositories/central/

Spring Boot 3.3.13
Spring Boot 3.3.13

Spring Boot下载页提供 3.3.13 官方源码 ZIP,并整理快速入门、项目创建、配置和自动配置说明。

下载

⚠️ 注意:URL 必须用 https,旧教程里的 http://maven.aliyun.com 已失效,会导致依赖拉取 403 错误。

另在 settings.xml 中取消注释 行,改为:
D:\Tools\maven-repo —— 把仓库从C盘挪走,避免系统盘爆满。

用 IntelliJ IDEA 创建第一个 Spring Boot 项目

第一步:启动 IDEA → 新建项目 → 左侧选 Spring Initializr → 右上角确认 SDK 已识别为 JDK 17(若显示 “No SDK”,点右侧小齿轮图标手动添加)。

第二步:填写项目元信息:
• Project SDK:选择你刚配好的 JDK 17
• Language:Java
• Spring Boot:选 3.3.x(当前最新稳定版)
• Packaging:Jar
• Java:17

第三步:勾选依赖 → 必须选 Spring Web,这是让项目能响应 HTTP 请求的最小依赖;其他如 Lombok、Spring Boot DevTools 按需勾选,**千万别乱加 MySQL 或 Redis,新手第一次跑不通全是依赖冲突惹的祸**。

第四步:设置包名(如 com.example.demo)→ 点击 Finish → IDEA 开始下载 starter 依赖,进度条走完即生成完整项目结构。

第五步:打开 DemoApplication.java,右键 → Run 'DemoApplication' → 控制台出现 Tomcat started on port(s): 8080 字样,说明启动成功。

验证项目是否真正跑通

src/main/java/com/example/demo 下新建包 controller,再新建类 HelloController

@RestController
public class HelloController {
 @GetMapping("/hello")
 public String sayHello() {
  return "Hello, Spring Boot!";
 }
}

保存后刷新浏览器,访问 http://localhost:8080/hello,页面显示纯文本 Hello, Spring Boot! —— 这才是真正的“Hello World”落地。

如果返回 404,请检查类是否加了 @RestController 注解、路径是否拼错、是否在正确包下(必须是主启动类同级或子包)、IDEA 是否已自动编译(File → Build Project)。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2111

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

397

25

NumPy性能优化版本更新与常见报错排查
NumPy性能优化版本更新与常见报错排查

本专题整理 NumPy 性能优化、版本更新与常见报错排查相关教程,覆盖向量化计算、广播性能、内存布局、NumPy 2.0 升级、版本兼容冲突、安装导入报错、dtype 溢出、矩阵运算异常和 broadcasting 报错修复,帮助读者系统掌握 NumPy 性能调优与问题定位方法。

2026.09.22

0

25

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

20

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

20

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

2026.09.20

40

13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Spring Boot 官方快速入门指南
Spring Boot 官方快速入门指南

共0课时 | 0人学习

Spring Boot 官方参考文档
Spring Boot 官方参考文档

共0课时 | 0人学习

尚硅谷新版SpringBoot3教程
尚硅谷新版SpringBoot3教程

共0课时 | 0人学习