利用 IntelliJ IDEA 快速搭建 Spring Boot Web 项目

结果或目标

在本教程完成后，你将拥有一个基于 Spring Boot 的独立 Java Web 项目。该项目内嵌 Tomcat 服务器，能够以 spring-boot-starter-web 模式运行，并可以通过 HTTP 请求返回预设的 JSON 或文本数据。

准备条件

1. 开发环境：推荐使用 IntelliJ IDEA（IDEA）作为集成开发环境，它比传统 Eclipse 更便于处理现代 Java 项目结构。
2. JDK：安装并配置好 Java Development Kit (JDK)。
3. Maven：确保系统已安装 Maven 并正确配置了环境变量。

真实操作顺序

第 1 步：创建空的 Maven 项目

目的：构建不包含任何预设模板（Archetype）的基础项目结构，避免选择错误模板带来的额外配置干扰。

入口：打开 IDEA，点击菜单栏 File → New → Project。

动作：

1. 在左侧面板选择 Maven 模板。

2. 右侧确认 JDK 版本是否正确加载。

3. 取消勾选底部的 “Create from archetype”，这将直接创建一个简单的空白项目。

4. 填写项目名称（Project Name）和 ArtifactId。建议两者保持一致以规范命名。

5. 点击 Finish 完成创建。此时项目将生成基本的 Maven 目录结构。

第 2 步：引入 Spring Boot Web 依赖

目的：添加 spring-boot-starter-web 依赖，该包自动集成了 Spring MVC 和嵌入式 Tomcat，是构建 Web 应用的必要基础。

入口：编辑项目根目录下的 pom.xml 文件。

动作：

在 <dependencies> 节点内加入以下配置。这里以 2.3.3.RELEASE 版本为例（生产环境中建议使用最新的稳定版）：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <version>2.3.3.RELEASE</version>
</dependency>

保存后，IDEA 通常会自动触发 Maven 的重新加载（Reload All Maven Projects）。确认下载进度条跑完，说明依赖已成功引入本地仓库。

第 3 步：创建并定位启动类

目的：提供一个带有主方法的入口点，并利用 @SpringBootApplication 注解激活自动配置功能。

入口：在项目的源代码目录（通常是 src/main/java）下创建 Java 类。

动作：

1. 建立包结构，例如 com.my.template。

2. 在该包下创建类 BootServer.java，代码如下：

package com.my.template;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class BootServer {
    public static void main(String[] args) {
        SpringApplication.run(BootServer.class, args);
    }
}

重要参数：位置必须正确。启动类应位于所有其他组件包（如 controller, service 等）的父包下。如果启动类放得太深，可能会导致 @Component 扫描不到同级或子级的 Bean，从而引发异常。

3. 右键点击 main 方法，选择 Run 'BootServer.main()'。

可观察的完成状态：控制台输出 Spring Boot 的启动日志，最后一行显示类似 Started BootServer in x.xxx seconds，且默认端口通常为 8080。

第 4 步：编写 Controller 验证服务

目的：通过一个简单的 HTTP 接口证明 Web 服务已正常响应。

入口：在 com.my.template.controller 包下创建新类。

动作：

1. 创建 TestServer.java：

package com.my.template.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
public class TestServer {
    @ResponseBody
    @RequestMapping("test")
    public String test(){
        return "hello springboot";
    }
}

2. 启动服务后，打开浏览器访问 http://127.0.0.1:8080/test。

可观察的完成状态：页面直接返回纯文本 hello springboot，即证明项目搭建及环境配置完全成功。

简要总结

本教程演示了从 IDEA 初始化 Maven 空白项目到成功运行 Spring Boot Web 接口的全流程。核心要点在于准确导入 spring-boot-starter-web 依赖，并确保启动类位于包结构的顶层以便进行正确的组件扫描。以上就是利用 IDEA 搭建 Spring Boot 项目的详细内容，更多关于 Spring Boot 进阶配置（如日志框架设置、多环境配置文件切换等）的资料请关注本站其它相关文章！