Java Web开发环境搭建全攻略：从零配置到Spring Boot项目上线

Java Web开发开发环境搭建Spring Boot

于 2026-08-04 04:11:25 修改

·本内容遵循CC 4.0 BY-SA版权协议

最近在整理本地项目时，发现一台闲置的旧笔记本，配置尚可，扔了可惜。恰好一位来自安阳许家沟的粉丝朋友在后台留言，提到想学习编程但手头设备老旧，运行开发环境非常吃力。沟通之后，决定把这台机器整理好，驱车三十多公里送过去，也算让旧物发挥余热，支持一下热爱技术的朋友。

这件事让我想到，很多初学者在技术入门时，除了学习资料，一个稳定、能流畅运行基础开发工具的环境同样重要。借着这次机会，我决定写一篇详细的教程，不仅记录如何为一台旧电脑“焕发新生”，打造成一个适合Java Web初学者使用的开发环境，更会系统梳理从系统选择、环境搭建到第一个Spring Boot项目上线的完整流程。无论你是刚拿到新电脑的学生，还是想让旧设备重新投入使用的开发者，这篇文章都能提供一套可复现的配置方案。

1. 背景与核心概念：为什么需要一个标准化的开发环境？

在开始动手之前，我们首先要明确目标：打造一个专为Java Web开发设计的本地环境。对于初学者而言，一个混乱、依赖冲突或配置不全的环境是学习路上最大的绊脚石，可能让你在“环境配置”阶段就耗尽热情。

核心目标环境包含：

操作系统：一个稳定、兼容性好的系统基础。本文以Windows 10/11为例，这也是国内用户最主流的系统。
Java开发工具包（JDK）：Java程序运行的基石，所有Java应用都离不开它。
集成开发环境（IDE）：IntelliJ IDEA Community（社区版），它提供了强大的代码编写、调试和管理功能，对初学者友好且免费。
项目构建与管理工具：Apache Maven，用于自动化管理项目依赖（第三方库）、构建、打包等生命周期。
版本控制系统：Git，用于管理代码版本，是团队协作和代码备份的必备工具。
数据库：MySQL，最流行的开源关系型数据库之一，是Web应用存储数据的核心。

将以上工具有机整合，就构成了一个最小化的Java Web开发“工作站”。接下来，我们将一步步实现它。

2. 环境准备与版本说明

在开始安装前，请确保你拥有电脑的管理员权限，并可以正常访问网络。以下是本文演示所使用的主要软件版本，你可以根据实际情况选择相同或更新的稳定版本。

组件	推荐版本	说明
操作系统	Windows 10 64位或 Windows 11	确保系统已更新至最新稳定版
JDK	OpenJDK 17 (LTS)	长期支持版本，兼顾稳定性和新特性
IntelliJ IDEA	2023.3.x Community Edition	使用最新的稳定社区版即可
Apache Maven	3.9.x	与JDK 17兼容性良好
Git	2.43.x	用于代码版本管理
MySQL	MySQL Community Server 8.0.x	目前广泛使用的版本

重要提示：版本需要根据你的项目实际情况调整。对于企业级老项目，可能需要JDK 8或11。本文示例以当前主流环境为例，重点演示配置思路和通用流程，版本差异通常不影响核心步骤。

3. 核心工具安装与配置详解

3.1 安装JDK并配置环境变量

JDK是运行Java程序的必需品。我们选择OpenJDK 17，因为它开源免费且是长期支持版本。

下载：访问 Adoptium 网站，选择 OpenJDK 17 (LTS)，下载 Windows x64 MSI Installer。
安装：运行下载的MSI文件，基本上一路“Next”即可。建议记住安装路径，例如 C:\Program Files\Eclipse Adoptium\jdk-17.0.10.7-hotspot。
配置环境变量：这是关键步骤，让系统在任何位置都能识别 java 和 javac 命令。
- 右键点击“此电脑” -> “属性” -> “高级系统设置” -> “环境变量”。
- 在“系统变量”部分，点击“新建”，变量名填 JAVA_HOME，变量值填你的JDK安装路径（例如 C:\Program Files\Eclipse Adoptium\jdk-17.0.10.7-hotspot）。
- 找到并编辑“系统变量”中的 Path 变量，点击“新建”，添加一条新记录：%JAVA_HOME%\bin。
验证：打开命令提示符（CMD）或 PowerShell，输入以下命令：

BASH

java -version

javac -version

如果正确显示JDK 17的版本信息，说明配置成功。

3.2 安装与配置Apache Maven

Maven能帮助我们自动下载和管理项目所需的库文件（Jar包）。

下载：访问 Maven官网，下载 Binary zip archive 版本，例如 apache-maven-3.9.6-bin.zip。
解压：将其解压到一个没有中文和空格的目录，例如 D:\DevTools\apache-maven-3.9.6。
配置环境变量：
- 新建系统变量 MAVEN_HOME，值为你的Maven解压路径（例如 D:\DevTools\apache-maven-3.9.6）。
- 编辑 Path 变量，新建并添加 %MAVEN_HOME%\bin。
配置本地仓库（可选但推荐）：Maven下载的jar包默认存放在用户目录下的 .m2/repository 文件夹。为了管理方便或重装系统时不丢失，可以更改其位置。
- 在 D:\DevTools（或你喜欢的目录）下新建一个文件夹，如 maven-repo。
- 打开Maven解压目录下的 conf/settings.xml 文件，找到 <localRepository> 标签，取消注释并修改为你的路径：
  
  XML
  
  <localRepository>D:\DevTools\maven-repo</localRepository>
验证：打开新的命令提示符，输入：

BASH

mvn -v

应显示Maven版本、JDK版本等信息。

3.3 安装Git

Git用于代码版本管理，也是IDEA无缝集成的工具。

下载：访问 Git官网，下载Windows版本安装程序。
安装：运行安装程序，大部分选项保持默认即可。在“选择默认编辑器”步骤，可以选择你熟悉的（如VSCode），但默认的Vim对新手可能不友好。在“调整PATH环境”步骤，建议选择第二项“Git from the command line and also from 3rd-party software”，这样Git命令可以在任何终端使用。
验证：打开命令提示符，输入：

BASH

git --version

显示版本号即成功。

3.4 安装与配置MySQL

MySQL是存储数据的地方。

下载：访问 MySQL社区版下载页，选择 MySQL Community (GPL) Downloads -> MySQL Community Server，下载Windows (x86, 64-bit) 的ZIP Archive版本（体积小，配置灵活）。
解压与初始化：
- 解压到指定目录，如 D:\DevTools\mysql-8.0.36-winx64。
- 在该目录下新建一个 my.ini 配置文件，内容如下（根据你的路径修改）：
  
  INI
  
  [mysqld]
  
  # 设置3306端口
  
  port=3306
  
  # 设置mysql的安装目录
  
  basedir=D:/DevTools/mysql-8.0.36-winx64
  
  # 设置mysql数据库的数据的存放目录
  
  datadir=D:/DevTools/mysql-8.0.36-winx64/data
  
  # 允许最大连接数
  
  max_connections=200
  
  # 允许连接失败的次数。这是为了防止有人从该主机试图攻击数据库系统
  
  max_connect_errors=10
  
  # 服务端使用的字符集默认为UTF8
  
  character-set-server=utf8mb4
  
  # 创建新表时将使用的默认存储引擎
  
  default-storage-engine=INNODB
  
  # 默认使用“mysql_native_password”插件认证
  
  default_authentication_plugin=mysql_native_password
  
  [mysql]
  
  # 设置mysql客户端默认字符集
  
  default-character-set=utf8mb4
  
  [client]
  
  # 设置mysql客户端连接服务端时默认使用的端口
  
  port=3306
  
  default-character-set=utf8mb4
- 以管理员身份打开命令提示符，导航到MySQL的 bin 目录（cd D:\DevTools\mysql-8.0.36-winx64\bin）。
- 执行初始化命令，这会生成 data 目录和初始数据库，并给出一个包含初始密码的输出，务必记下这个临时密码：
  
  BASH
  
  mysqld --initialize --console
- 安装MySQL服务：
  
  BASH
  
  mysqld --install MySQL
- 启动MySQL服务：
  
  BASH
  
  net start MySQL
登录并修改root密码：
- 继续在 bin 目录下，使用刚才记下的临时密码登录：
  
  BASH
  
  mysql -u root -p
- 登录成功后，立即修改密码（将 your_new_password 替换为你的强密码）：
  
  SQL
  
  ALTER USER 'root'@'localhost' IDENTIFIED BY 'your_new_password';
  
  FLUSH PRIVILEGES;
- 输入 exit 退出。

3.5 安装IntelliJ IDEA

IDEA是我们的主战场。

下载：访问 JetBrains官网，下载免费的Community版本。
安装：运行安装程序，选择安装路径，在“安装选项”界面，建议勾选“创建桌面快捷方式”、“.java关联”等。在“选择开始菜单文件夹”和“选择安装位置”步骤按需选择即可。
首次运行与基础配置：
- 首次启动，会询问是否导入设置，选择“Do not import settings”。
- 进入欢迎界面后，点击 Customize -> All settings... 进入详细设置。
- 关键配置：
  - Build, Execution, Deployment -> Build Tools -> Maven：检查 Maven home path 是否自动识别到了我们安装的Maven路径，User settings file 是否指向了我们修改过的 settings.xml。Local repository 应显示为我们配置的本地仓库路径。
  - Version Control -> Git：在 Path to Git executable 中，IDEA通常能自动找到Git安装路径，请确认是否正确。
  - Plugins：可以搜索并安装一些常用插件，如 Chinese (Simplified) Language Pack（中文语言包）、MyBatisX（MyBatis增强）等，初学者可暂不安装。

4. 完整实战案例：创建并运行第一个Spring Boot项目

环境就绪，现在我们来创建一个最简单的Spring Boot Web应用，验证整个环境是否工作正常。

4.1 使用IDEA创建项目

在IDEA欢迎界面点击 New Project。
左侧选择 Spring Initializr。Server URL 使用默认的 https://start.spring.io。
填写项目信息：
- Name: demo-first-springboot
- Location: 选择你的项目存放目录。
- Language: Java
- Type: Maven
- Group: com.example (通常使用公司域名倒写)
- Artifact: demo (与Name一致也可)
- Package name: 会自动生成 com.example.demo
- JDK: 选择我们安装的JDK 17。
点击 Next，选择Spring Boot版本（如 3.2.5，选择带 (SNAPSHOT) 的稳定版），并添加依赖：
- 在搜索框中输入 web，勾选 Spring Web。
- 输入 lombok，勾选 Lombok（用于简化Java Bean代码）。
点击 Next，确认项目名称和位置，点击 Finish。IDEA会自动下载项目模板和依赖，首次创建可能需要一些时间。

4.2 项目结构解析与编写代码

项目创建完成后，左侧项目结构大致如下：

TEXT

demo-first-springboot

├── src

│ ├── main

│ │ ├── java

│ │ │ └── com

│ │ │ └── example

│ │ │ └── demo

│ │ │ └── DemoApplication.java // 主启动类

│ │ └── resources

│ │ ├── application.properties // 配置文件

│ │ └── static

│ │ └── templates

│ └── test // 测试目录

├── pom.xml // Maven项目对象模型，管理依赖

└── ...

创建控制器：在 com.example.demo 包下，新建一个Java类 HelloController.java。

JAVA

package com.example.demo;

import org.springframework.web.bind.annotation.GetMapping;

import org.springframework.web.bind.annotation.RestController;

@RestController // 表明这是一个REST风格的控制器

public class HelloController {

@GetMapping("/hello") // 处理GET请求，路径为 /hello

public String sayHello() {

return "Hello, CSDN! This is my first Spring Boot app from Anyang!";

}

}
修改配置文件（可选）：打开 src/main/resources/application.properties，可以修改服务器端口（默认8080可能被占用）：

PROPERTIES

server.port=8081

4.3 运行与验证

找到主启动类 DemoApplication.java，其内容如下：

JAVA

package com.example.demo;

import org.springframework.boot.SpringApplication;

import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication // 核心注解，标识这是一个Spring Boot应用

public class DemoApplication {

public static void main(String[] args) {

SpringApplication.run(DemoApplication.class, args); // 启动应用

}

}
点击 DemoApplication 类旁边的绿色三角形运行按钮，或在类内右键选择 Run ‘DemoApplication‘。
观察IDEA下方的 Run 工具窗口，看到类似以下的日志，说明启动成功：

TEXT

... Tomcat started on port(s): 8081 (http) with context path ''

... Started DemoApplication in 3.456 seconds (process running for 3.789)
验证：打开你的浏览器，访问 http://localhost:8081/hello。如果页面显示 Hello, CSDN! This is my first Spring Boot app from Anyang!，那么恭喜你，第一个Spring Boot应用成功运行！这证明你的JDK、Maven、IDEA和Spring Boot环境全部配置正确且协同工作正常。

5. 常见问题与排查思路

在环境搭建和项目运行过程中，你可能会遇到以下常见问题：

问题现象	可能原因	排查思路与解决方案
`‘java‘ 不是内部或外部命令`	JDK环境变量未正确配置。	1. 检查 `JAVA_HOME` 变量值是否为JDK安装路径（不是bin目录）。 2. 检查 `Path` 中是否包含 `%JAVA_HOME%\bin`。 3. 重要：修改环境变量后，必须关闭并重新打开命令提示符或终端才能生效。
`‘mvn‘ 不是内部或外部命令`	Maven环境变量未正确配置。	1. 检查 `MAVEN_HOME` 变量值是否为Maven解压路径。 2. 检查 `Path` 中是否包含 `%MAVEN_HOME%\bin`。 3. 同样需要重启终端。
IDEA创建项目时卡在`Downloading...`	Maven仓库地址网络连接慢或IDEA未使用自定义配置。	1. 检查IDEA的Maven设置，确认使用的是自定义的 `settings.xml` 文件。 2. 在 `settings.xml` 的 `<mirrors>` 标签内配置国内镜像源（如阿里云镜像），大幅提升下载速度。
Spring Boot应用启动失败，端口被占用	8080或8081端口已被其他程序（如另一个Tomcat、Skype等）使用。	1. 在命令行执行 `netstat -ano
运行DemoApplication时报`ClassNotFoundException` 或 `NoClassDefFoundError`	Maven依赖未正确下载或项目依赖未导入。	1. 在IDEA右侧边栏点击 `Maven` 标签，点击刷新按钮（Reimport All Maven Projects）。 2. 检查项目根目录下的 `pom.xml` 文件是否有红色错误提示，修正依赖坐标。 3. 检查本地仓库路径是否正确，可尝试删除有问题的依赖目录，让Maven重新下载。
访问 `localhost:8081/hello` 报404错误	控制器路径映射错误或应用未成功启动。	1. 确认应用启动日志无报错且显示 `Started ...`。 2. 检查 `HelloController` 类上的 `@RestController` 注解和方法上的 `@GetMapping(“/hello”)` 注解是否正确。 3. 确认访问的URL路径与注解中定义的完全一致（注意大小写）。

6. 最佳实践与工程建议

一个能跑通的环境只是起点，要使其稳定、高效地服务于开发，还需要遵循一些最佳实践。

环境隔离与版本管理：
- 使用版本管理工具：强烈建议将 pom.xml、build.gradle 等构建脚本纳入Git管理。对于团队项目，使用 .gitignore 文件忽略 target/、*.iml、.idea/ 等本地生成文件和IDE配置。
- 考虑使用Docker：对于更复杂的环境（如特定版本的Redis、Elasticsearch），学习使用Docker可以做到环境的一次构建，处处运行，避免“在我机器上是好的”问题。
项目结构与配置：
- 分层清晰：遵循标准的MVC或领域驱动设计分层，如 controller, service, repository/dao, entity/domain, config 等。
- 多环境配置：使用Spring Boot的 application-{profile}.properties/yml 特性，区分开发（dev）、测试（test）、生产（prod）环境的配置。
  - application-dev.properties: 开发环境，连接本地数据库。
  - application-prod.properties: 生产环境，连接线上数据库，配置日志级别等。
  - 通过启动参数 --spring.profiles.active=dev 来激活指定配置。
依赖管理：
- 明确版本：在 pom.xml 的 <properties> 中统一定义常用依赖的版本号，避免冲突。
- 定期更新：定期检查并更新依赖到稳定版本，修复安全漏洞。但生产环境升级前务必在测试环境充分验证。
数据库操作安全：
- 永远不要在生产环境直接执行未经验证的SQL：尤其是 DELETE、UPDATE、DROP 操作。务必先 SELECT 确认数据，并在测试环境演练。
- 使用连接池与配置分离：数据库连接密码等敏感信息不要硬编码在代码中，应通过环境变量或配置中心注入。
- SQL注入防范：使用MyBatis、JPA等框架时，优先使用 #{} 参数绑定，而非字符串拼接 ‘${}‘。
日志与监控：
- 合理记录日志：使用SLF4J + Logback/Log4j2，在关键业务逻辑、异常捕获处记录日志，级别从 DEBUG 到 ERROR 合理选择。
- 日志格式规范：输出日志应包含时间、级别、线程、类名、消息等信息，便于排查问题。

为那位许家沟的朋友配置好电脑，并看着他成功运行起第一个Spring Boot项目时，那种成就感不亚于解决一个复杂的技术难题。技术学习的道路有时会因环境问题而显得崎岖，希望这篇超详细的指南能像一份手把手的地图，帮你平稳度过入门初期的配置关卡。记住，环境搭建是基本功，熟练之后，你就可以将更多精力投入到更有趣的业务逻辑和架构设计中去。如果在实践中遇到文中未覆盖的新问题，欢迎在评论区交流，共同探讨解决。