基于IDEA+SpringBoot+Mave+Thymeleaf的系统实现-EW帮帮网

一. 安装IntelliJ IDEA

下载并安装IntelliJ IDEA Ultimate或Community版

2024年最新版IntelliJ IDEA下载安装过程（含Java环境搭建）

二、下载 Maven

访问官网下载
打开浏览器，访问 Maven 官方下载页面：
Download Apache Maven – Maven
选择版本
下载最新的稳定版本（Binary zip archive），例如：
apache-maven-3.8.6-bin.zip
解压文件
将下载的 zip 文件解压到本地目录（建议路径简单，如 C:\maven）

三、配置环境变量

打开系统属性
- 按 Win + R，输入 sysdm.cpl 回车
- 切换到高级选项卡 → 点击 环境变量
新建系统变量
- 点击 系统变量 下的新建
- 变量名：MAVEN_HOME
- 变量值：Maven 解压路径（如 C:\maven\apache-maven-3.8.6）
编辑 Path 变量
- 在系统变量中找到 Path → 点击编辑
- 点击新建，添加：%MAVEN_HOME%\bin
验证安装
打开命令提示符（CMD），输入：
```
mvn -version
```
若显示 Maven 版本信息（如 Apache Maven 3.8.6），则配置成功

具体操作截图如下

四、配置 IDEA 使用本地 Maven

打开 IDEA 设置
- 菜单栏：File → Settings（Windows）或 IntelliJ IDEA → Preferences（Mac）
配置 Maven 路径
导航到：
Build, Execution, Deployment → Build Tools → Maven
- Maven home path：选择本地 Maven 解压目录（如 C:\maven\apache-maven-3.8.6）
- User settings file：指定 settings.xml 路径（通常在 conf 目录下）

配置阿里云镜像（可选）
编辑 settings.xml，在 <mirrors> 标签内添加：

  <!-- 本地仓库路径（按需修改） -->
  <localRepository>D:\J2EE\Maven\apache-maven-3.9.9-bin\apache-maven-3.9.9\repository</localRepository>

  <!-- 镜像配置 -->
  <mirrors>
    <!-- 阿里云镜像（主仓库） -->
    <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>

五、常见问题解决

mvn -version 不生效
- 检查环境变量是否配置正确
- 重启 CMD 或 IDEA 使配置生效
IDEA 无法识别 Maven
- 确保路径中没有中文或特殊字符
- 在 IDEA 中右键项目 → Maven → Reimport
依赖下载慢
- 确认阿里云镜像配置正确
- 尝试关闭防火墙或更换网络

六、验证 SpringBoot 创建的三种方式

（一）、IDEA创建SpringBoot项目/通过Maven创建（手动配置依赖）

（1）File → New → Project->java->Maven

（2）选择Maven项目

（3）手动添加SpringBoot依赖到pom.xml

添加依赖可能会报错，检查Maven的IDEA本地配置

修改成如图所示

添加依赖成功

（4）创建启动类 `App.java`

在 src/main/java 下创建包（如 org.example），然后新建 App.java：内容如下

package org.example;//替换为实际包名

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@EnableAutoConfiguration
@RestController

public class App {
    public static void main(String[]args){
        SpringApplication.run(App.class,args);
    }
    @GetMapping("/hello")
    public String hello(){
        return "hello,Spring Boot!";
    }
}

（5）验证项目结构

确保目录结构如下（符合 Maven 标准）：

demo01/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── com/example/demo/  # 你的包路径
│   │   │       └── App.java       # 启动类
│   │   └── resources/             # 配置文件目录（如application.properties）
│   └── test/                      # 测试代码

（6）运行应用

方式一：通过 IntelliJ IDEA

右键点击 App 类 → Run 'App.main()'

控制台出现以下日志表示成功：

Started App in 20.944 seconds (process running for 1.467)

方式二：通过命令行

mvn spring-boot:run  # 使用Spring Boot Maven插件运行

运行发现报错，这是由于 Maven 找到了多个可能的启动类（org.example.Main 和 org.example.App），但无法确定应该使用哪一个来运行 Spring Boot 应用。

解决方法有

1. 明确指定主启动类

在 pom.xml 中通过 <configuration> 指定主类：

<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
            <configuration>
                <mainClass>org.example.App</mainClass>  <!-- 明确指定App类为主类 -->
            </configuration>
        </plugin>
    </plugins>
</build>

2. 检查重复的启动类

删除或重命名项目中多余的启动类（如 org.example.Main），确保只有一个类包含 main 方法。

再次运行

（7）访问默认端点

启动后，Spring Boot 会初始化一个嵌入式 Tomcat 服务器（默认端口 8080）。
在浏览器访问：

http://localhost:8080

如果看到 Whitelabel Error Page（404），说明服务已启动但未定义路由，接下来可以添加 Controller。这里我先不添加Controller，要学习添加Controller可以移动到后面目录第八点的内容。

（8）添加测试接口（可选）

修改App.java如下：

package org.example;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@EnableAutoConfiguration
@RestController

public class App {
    public static void main(String[]args) {
        SpringApplication.run(App.class, args);
    }
        @GetMapping("/hello")
                public String hello(){
            return "hello,spring boot";
        }
    }

重启应用后访问：

http://localhost:8080/hello

应返回：Hello, Spring Boot!

（9）常见问题排查

端口冲突：
如果 8080 被占用，在 src/main/resources/application.properties 中修改端口：
```
server.port=8081
```
依赖缺失：
确保 pom.xml 中已正确引入 spring-boot-starter-web（之前已修复格式问题）。
类扫描问题：
App 类必须放在其他类（如 Controller）的上级包中，否则需手动指定扫描路径：
```
@SpringBootApplication(scanBasePackages = "com.example")
```

（二）、在线创建Spring Boot项目（可选）

在线创建Spring Boot项目是官方提供的一种创建方式，官网地址为

https://start.spring.io/

在页面中将信息填完后，单击GENERATE按钮生成模块并下载到本地，解压后使用IDEA打开该项目即可

打开demo里面内容

通过IDEA打开该项目

（三）、使用Spring Initializer快速创建（可选）

上述创建Spring Boot的两种方式都比较繁琐，而Spring Initializer不但可以生成完整的目录结构，还可以生成一个默认主程序，从而节省时间

生成的项目通常包含以下结构：

项目根目录/
├── src/
│ ├── main/
│ │ ├── java/
│ │ │ └── com/example/demo/
│ │ │ └── DemoApplication.java # 主启动类
│ │ └── resources/
│ │ ├── static/ # 静态资源(JS/CSS/图片)
│ │ ├── templates/ # 模板文件
│ │ ├── application.properties # 配置文件
│ │ └── application.yml # 另一种配置格式
│ └── test/ # 测试代码
├── .gitignore # Git忽略规则
└── pom.xml # Maven配置文件(或build.gradle)

点击右上角三角形运行，显示如下则运行成功

七、pom.xml中引入thymeleaf依赖，在classpath:/templates/下新建HTML页面

1、在pom.xml文件中引入Thymeleaf依赖

<!-- 在 <dependencies> 部分添加以下内容 -->
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

完整的pom.xml如下

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<parent>
		<groupId>org.springframework.boot</groupId>
		<artifactId>spring-boot-starter-parent</artifactId>
		<version>3.2.0</version>
		<relativePath/> <!-- lookup parent from repository -->
	</parent>
	<groupId>org.example</groupId>
	<artifactId>demo4</artifactId>
	<version>0.0.1-SNAPSHOT</version>
	<name>demo4</name>
	<description>demo4</description>
	<url/>
	<licenses>
		<license/>
	</licenses>
	<developers>
		<developer/>
	</developers>
	<scm>
		<connection/>
		<developerConnection/>
		<tag/>
		<url/>
	</scm>
	<properties>
		<java.version>17</java.version>
	</properties>
	<dependencies>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-web</artifactId>
		</dependency>

		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-test</artifactId>
			<scope>test</scope>
		</dependency>
		<!-- 在 <dependencies> 部分添加以下内容 -->
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-starter-thymeleaf</artifactId>
		</dependency>
	</dependencies>

	<build>
		<plugins>
			<plugin>
				<groupId>org.springframework.boot</groupId>
				<artifactId>spring-boot-maven-plugin</artifactId>
			</plugin>
		</plugins>
	</build>

</project>

2、在classpath:/templates/下新建HTML页面

在每个页面的html文件导入Thymeleaf的空间命名，以获得更好的提示

<html xmlns:th="http://www.thymeleaf.org">

在classpath:/templates/下新建HTML测试页面test.html

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>测试页面</title>
</head>
<body>
<h1 th:text="${message}">默认标题</h1>
<p>状态: <span th:text="${status}">加载中...</span></p>
</body>
</html>

八、添加 Controller

在java文件目录下创建controller.java

代码如下

package org.example.demo4;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
import java.util.Arrays;
import java.util.List;

@Controller
public class controller {

    @GetMapping("/test")
    public String testPage(Model model) {
        model.addAttribute("message", "测试成功！");
        model.addAttribute("status", "SUCCESS");
        return "test"; // 对应 templates/test.html
    }
}

点击左上角三角运行，显示如下运行成功

最后在浏览器访问http://localhost:8080/test看到如下界面则成功

基于IDEA+SpringBoot+Mave+Thymeleaf的系统实现

一. 安装IntelliJ IDEA

二、下载 Maven

三、配置环境变量

四、配置 IDEA 使用本地 Maven

五、常见问题解决

六、验证 SpringBoot 创建的三种方式

（一）、IDEA创建SpringBoot项目/通过Maven创建（手动配置依赖）

（1）File → New → Project->java->Maven

（2）选择Maven项目

（3）手动添加SpringBoot依赖到pom.xml

（4）创建启动类 `App.java`

（5）验证项目结构

（6）运行应用

1. 明确指定主启动类

2. 检查重复的启动类

（7）访问默认端点

（8）添加测试接口（可选）

（9）常见问题排查

（二）、在线创建Spring Boot项目（可选）

（三）、使用Spring Initializer快速创建（可选）

七、pom.xml中引入thymeleaf依赖，在classpath:/templates/下新建HTML页面

1、在pom.xml文件中引入Thymeleaf依赖

2、在classpath:/templates/下新建HTML页面

八、添加 Controller

网站公告

今日签到

热门文章

最新发布

基于IDEA+SpringBoot+Mave+Thymeleaf的系统实现

一. 安装IntelliJ IDEA

二、下载 Maven

三、配置环境变量

四、配置 IDEA 使用本地 Maven

五、常见问题解决

六、验证 SpringBoot 创建的三种方式

（一）、IDEA创建SpringBoot项目/通过Maven创建（手动配置依赖）

（1）File → New → Project->java->Maven

（2）选择Maven项目

（3）手动添加SpringBoot依赖到pom.xml

（4）创建启动类 App.java

（5） 验证项目结构

（6）运行应用

1. 明确指定主启动类

2. 检查重复的启动类

（7）访问默认端点

（8） 添加测试接口（可选）

（9）常见问题排查

（二）、在线创建Spring Boot项目（可选）

（三）、使用Spring Initializer快速创建（可选）

七、pom.xml中引入thymeleaf依赖，在classpath:/templates/下新建HTML页面

1、在pom.xml文件中引入Thymeleaf依赖

2、在classpath:/templates/下新建HTML页面

八、添加 Controller

网站公告

今日签到

热门文章

最新发布

（4）创建启动类 `App.java`

（5）验证项目结构

（8）添加测试接口（可选）