部署一个 Spring Boot 项目时,新手需要关注的“依赖”主要分为两类:
- 开发环境依赖(构建工具依赖)
- 运行环境依赖(服务器/系统依赖)
下面为你详细说明:
一、开发环境依赖(本地开发和打包)
这些是你在编写和打包 Spring Boot 应用时需要安装的软件或工具。
✅ 1. JDK(Java Development Kit)
- 版本要求:Spring Boot 3.x 需要 JDK 17 或更高;Spring Boot 2.x 支持 JDK 8+。
- 推荐使用 OpenJDK 或 Oracle JDK。
- 安装后配置
JAVA_HOME环境变量。
示例:
java -version应能输出版本信息。
✅ 2. 构建工具(任选其一)
Spring Boot 项目通常使用以下构建工具管理依赖:
- Maven(推荐新手使用)
- 下载并安装 Apache Maven
- 配置
MAVEN_HOME和PATH
- Gradle(更灵活,但学习曲线稍陡)
- 可使用 Gradle Wrapper(无需手动安装)
大多数 Spring Boot 初始项目都提供
pom.xml(Maven)或build.gradle(Gradle)文件。
✅ 3. IDE(可选但推荐)
- IntelliJ IDEA(社区版或专业版)
- Eclipse + Spring Tools Suite (STS)
- VS Code + Java 插件
二、运行环境依赖(部署到服务器)
当你把项目打包成 JAR 文件后,部署到服务器上只需要:
✅ 1. 目标服务器上的 JDK/JRE
- 只需安装 JRE 或 JDK(与你打包时使用的版本兼容)
- 例如:如果你用 JDK 17 打包,服务器也需 JDK 17+
注意:Spring Boot 推荐打包为 可执行 JAR,内嵌 Tomcat,无需外部 Web 服务器。
✅ 2. 操作系统支持
- Windows、Linux、macOS 均可运行
- 生产环境推荐 Linux(如 Ubuntu、CentOS)
✅ 3. 其他可能依赖(根据项目功能)
| 功能 | 所需依赖 |
|---|---|
| 数据库访问(如 MySQL) | 安装 MySQL 驱动(Maven 中引入即可),数据库服务需运行 |
| Redis 缓存 | 服务器需安装并运行 Redis |
| MongoDB | 安装 MongoDB 服务 |
| 消息队列(如 RabbitMQ/Kafka) | 对应中间件服务 |
| Nginx(反向X_X) | 如需做负载均衡或静态资源X_X |
⚠️ 注意:这些是服务依赖,不是本地开发必须安装的,但部署时若用到就要确保服务可用。
三、Spring Boot 项目本身的依赖(通过 pom.xml 管理)
你不需要手动“安装”这些,只需在 pom.xml 中声明,Maven 会自动下载。
常见 starter 依赖示例:
<dependencies>
<!-- Web 开发 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 数据库 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<scope>runtime</scope>
</dependency>
<!-- 热部署(开发时用) -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-devtools</artifactId>
<scope>runtime</scope>
<optional>true</optional>
</dependency>
<!-- 测试 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
四、部署步骤简要
- 使用
mvn clean package打包生成.jar文件 - 将 JAR 文件上传到服务器
- 运行命令:
java -jar your-app.jar - 访问
http://服务器IP:端口
总结:新手需要安装什么?
| 类别 | 必须? | 名称 |
|---|---|---|
| ✅ 必装 | 是 | JDK(17+ 推荐) |
| ✅ 必装 | 是 | Maven 或 Gradle |
| ✅ 必装 | 是 | 文本编辑器或 IDE |
| ✅ 必装(部署时) | 是 | 服务器上的 JDK |
| 🔹 按需 | 否 | MySQL、Redis、Nginx 等服务 |
| 🔹 推荐 | 是 | Git(版本控制) |
✅ 建议新手起步流程:
- 安装 JDK 17
- 安装 Maven
- 使用 https://start.spring.io 生成一个简单 Web 项目
- 导入 IDE,运行
main方法 - 打包并尝试在本地运行
java -jar xxx.jar
这样你就完成了从零到部署的完整流程!
如有具体部署场景(如云服务器、Docker),可以进一步细化。欢迎继续提问!
云小栈