news 2026/2/26 14:22:22

Spring Boot 开发入门：从 0 到 1 搭建第一个 Web 项目

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
Spring Boot 开发入门：从 0 到 1 搭建第一个 Web 项目

前言

Spring Boot 是由 Pivotal 团队推出的基于 Spring 框架的轻量级开发框架，它简化了 Spring 应用的配置流程，通过 “约定大于配置” 的核心思想，让开发者无需繁琐的 XML 配置就能快速搭建和运行项目。本文将从环境准备、项目创建、核心代码编写到运行测试，手把手教你入门 Spring Boot 开发，全程附带可运行的代码示例，新手也能轻松上手！

一、前置准备

1. 环境要求

  • JDK：推荐 JDK 8 及以上（Spring Boot 3.x 需 JDK 17+，本文以 Spring Boot 2.7.x + JDK 8 为例）；
  • Maven/Gradle：项目构建工具，本文使用 Maven；
  • 开发工具：IntelliJ IDEA（推荐）或 Eclipse；
  • 浏览器 / Postman：用于接口测试。

2. 验证环境

打开终端 / 命令行，执行以下命令验证环境是否配置成功：

bash

运行

# 验证JDK java -version # 验证Maven mvn -v

若输出对应版本信息，说明环境配置完成。

二、创建 Spring Boot 项目

方式 1：通过 Spring Initializr（官方脚手架）创建

这是最推荐的方式，可快速生成标准化项目结构：

  1. 打开 Spring Initializr 官网；
  2. 配置项目基础信息：
    • Project：Maven Project（本文选 Maven）；
    • Language：Java；
    • Spring Boot Version：2.7.x（稳定版）；
    • Project Metadata：
      • Group：自定义（如 com.example）；
      • Artifact：项目名（如 spring-boot-demo）；
      • Name：spring-boot-demo；
      • Description：Spring Boot 入门示例；
      • Package Name：com.example.demo；
      • Packaging：Jar（Spring Boot 推荐 Jar 包运行）；
      • Java Version：8；
  3. 添加依赖：在「Dependencies」中搜索并添加Spring Web（Web 开发核心依赖）；
  4. 点击「Generate」下载项目压缩包，解压后用 IDEA 打开。

方式 2：IDEA 直接创建（更便捷）

  1. 打开 IDEA → 新建项目 → 选择「Spring Initializr」；
  2. 按上述步骤配置项目信息和依赖，点击「Next」→「Finish」，IDEA 会自动下载依赖并生成项目结构。

三、项目核心结构解析

生成的项目默认结构如下（核心目录）：

plaintext

spring-boot-demo/ ├── src/ │ ├── main/ │ │ ├── java/ │ │ │ └── com/ │ │ │ └── example/ │ │ │ └── demo/ │ │ │ └── DemoApplication.java // 项目启动类（核心） │ │ └── resources/ │ │ ├── application.properties // 全局配置文件 │ │ ├── static/ // 静态资源（CSS/JS/图片） │ │ └── templates/ // 模板文件（Thymeleaf等） │ └── test/ // 测试目录 └── pom.xml // Maven依赖配置文件
  • DemoApplication.java：项目入口，包含@SpringBootApplication注解，启动 Spring Boot 应用；
  • application.properties：配置文件，可设置端口、数据库连接等（也可使用.yml 格式）；
  • pom.xml：管理项目依赖，Spring Boot 已内置父依赖，无需手动配置版本。

四、核心代码编写

1. 启动类（自动生成，无需修改）

DemoApplication.java是项目的启动入口，代码如下：

java

运行

package com.example.demo; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; /** * Spring Boot 启动类 * @SpringBootApplication 是核心注解，包含： * 1. @Configuration：标记为配置类 * 2. @EnableAutoConfiguration：开启自动配置 * 3. @ComponentScan：扫描当前包及子包下的组件 */ @SpringBootApplication public class DemoApplication { public static void main(String[] args) { // 启动Spring Boot应用 SpringApplication.run(DemoApplication.class, args); } }

2. 编写第一个 Controller（接口开发）

在com.example.demo包下新建controller目录，创建HelloController.java，用于处理 HTTP 请求：

java

运行

package com.example.demo.controller; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; /** * @RestController：组合注解，等价于 @Controller + @ResponseBody * 表示该类是控制器，且返回值直接作为JSON/字符串响应，而非视图 */ @RestController @RequestMapping("/hello") // 统一请求路径前缀 public class HelloController { // 示例1：基础GET请求，返回字符串 @GetMapping("/say") public String sayHello() { return "Hello, Spring Boot!"; } // 示例2：带路径参数的GET请求 @GetMapping("/user/{name}") public String sayHelloToUser(@PathVariable String name) { return "Hello, " + name + "! Welcome to Spring Boot World."; } // 示例3：返回JSON格式数据（Spring Boot自动序列化） @GetMapping("/info") public User getUserInfo() { User user = new User(); user.setId(1); user.setName("张三"); user.setAge(25); return user; } // 内部静态类：用户实体 static class User { private Integer id; private String name; private Integer age; // 必须提供getter方法，否则JSON序列化会缺失字段 public Integer getId() { return id; } public void setId(Integer id) { this.id = id; } public String getName() { return name; } public void setName(String name) { this.name = name; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } } }

3. 配置文件自定义（可选）

默认配置文件application.properties可修改端口、应用名等：

properties

# 应用名称 spring.application.name=spring-boot-demo # 服务端口（默认8080，可自定义） server.port=8081 # 编码格式 server.servlet.encoding.force=true server.servlet.encoding.charset=UTF-8

也可改为application.yml（更简洁的格式）：

yaml

spring: application: name: spring-boot-demo server: port: 8081 servlet: encoding: force: true charset: UTF-8

五、运行与测试项目

1. 启动项目

有两种启动方式：

  • 方式 1：在 IDEA 中直接运行DemoApplication.java的main方法；
  • 方式 2：通过 Maven 命令启动（终端进入项目根目录）：

    bash

    运行

    # 打包（可选） mvn clean package # 启动项目 mvn spring-boot:run

启动成功后，控制台会输出如下日志（关键信息）：

plaintext

Started DemoApplication in 2.531 seconds (JVM running for 3.012)

2. 接口测试

打开浏览器或 Postman，访问以下地址验证接口：

  • 测试基础接口：http://localhost:8081/hello/say响应：Hello, Spring Boot!
  • 测试带参数接口：http://localhost:8081/hello/user/李四响应：Hello, 李四! Welcome to Spring Boot World.
  • 测试 JSON 接口：http://localhost:8081/hello/info响应（JSON 格式）：

    json

    { "id": 1, "name": "张三", "age": 25 }

六、核心知识点补充

1. @SpringBootApplication 注解

该注解是 Spring Boot 的核心注解，整合了三个关键注解：

  • @Configuration：将类标记为配置类，可定义 Bean；
  • @EnableAutoConfiguration：开启自动配置，Spring Boot 根据依赖自动配置组件（如引入 Spring Web 则自动配置 Tomcat、DispatcherServlet）；
  • @ComponentScan：扫描当前包及子包下的@Controller、@Service、@Repository、@Component等注解的类。

2. 依赖管理

Spring Boot 通过spring-boot-starter-parent父依赖统一管理依赖版本，无需手动指定版本号。常用 starter 依赖：

  • spring-boot-starter-web：Web 开发（包含 Tomcat、Spring MVC）；
  • spring-boot-starter-data-jpa：JPA 操作数据库；
  • spring-boot-starter-mybatis：MyBatis 整合；
  • spring-boot-starter-test：单元测试。

3. 打包与运行

通过mvn clean package可将项目打包为 Jar 包，直接通过以下命令运行（无需部署到 Tomcat）：

bash

运行

java -jar target/spring-boot-demo-0.0.1-SNAPSHOT.jar

七、常见问题及解决

1. 端口被占用

修改application.properties中的server.port（如改为 8082），或关闭占用端口的进程。

2. 依赖下载慢

在pom.xml中添加阿里云 Maven 镜像：

xml

<repositories> <repository> <id>aliyunmaven</id> <url>https://maven.aliyun.com/repository/public</url> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>aliyunmaven</id> <url>https://maven.aliyun.com/repository/public</url> </pluginRepository> </pluginRepositories>

3. 启动时报 “找不到主类”

检查pom.xml中是否添加了 Spring Boot 插件：

xml

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

八、总结

本文从环境准备到项目运行，完整演示了 Spring Boot 第一个 Web 项目的搭建过程，核心要点：

  1. Spring Boot 核心是 “约定大于配置”，通过 starter 依赖和自动配置简化开发；
  2. @SpringBootApplication是启动类的核心注解，整合了配置、自动配置、组件扫描；
  3. @RestController用于开发 RESTful 接口，返回 JSON / 字符串响应；
  4. 项目可直接打包为 Jar 包运行，无需外部容器。

后续可进一步学习 Spring Boot 整合数据库（MyBatis/MySQL）、拦截器、全局异常处理、配置文件多环境切换等内容，逐步掌握 Spring Boot 核心能力。如果本文对你有帮助，欢迎点赞收藏，有疑问可在评论区交流～

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/2/20 15:28:04

Day 42 图像数据与显存

文章目录 Day 42 图像数据与显存1. 图像数据基础1.1 灰度图像&#xff08;MNIST&#xff09;1.2 彩色图像&#xff08;CIFAR-10&#xff09; 2. 图像相关的神经网络2.1 灰度图像 MLP&#xff08;MNIST&#xff09;2.2 彩色图像 MLP&#xff08;CIFAR-10&#xff09;2.3 batch_…

作者头像 李华
网站建设 2026/2/25 12:23:56

从OneCode看注解革命：Cursor热潮下的国产可视化开源工具新标杆

Cursor 2.0的可视化风暴&#xff0c;让“所见即所得”成为编程效率革命的核心关键词。但在众多可视化工具中&#xff0c;OneCode以“注解驱动双向联动”的独特技术路径脱颖而出——它不只是简单的组件拖拽&#xff0c;更通过标准化注解体系实现了“可视化操作”与“规范代码”的…

作者头像 李华
网站建设 2026/2/25 22:46:53

何时用回溯法？何时用普通 DFS？

要明确「何时用回溯法」「何时用普通 DFS」&#xff0c;核心是抓住目标导向和状态管理两个关键 —— 普通 DFS 侧重「无差别遍历 / 验证」&#xff0c;回溯法侧重「有目的试错找解」。以下是具体判断标准、场景和实例&#xff1a;一、核心判断准则&#xff08;先记这 3 点&…

作者头像 李华
网站建设 2026/2/23 21:30:15

Java 日期时间处理详解

Java 日期时间处理详解 引言 在编程中，对日期和时间的处理是一个非常重要的方面。特别是在Java编程语言中，日期和时间的处理尤为重要，因为它涉及到许多日常应用，如用户信息管理、文件时间戳、数据库操作等。Java提供了丰富的类和工具来处理日期和时间，本文将对Java中的日…

作者头像 李华
网站建设 2026/2/24 7:39:02

测试环境如何生成自签名证书用于 HTTPS

适用场景&#xff1a;本地开发、内网系统、测试环境、Spring Boot、Nginx 在开发或测试阶段&#xff0c;我们经常需要使用 https:// 访问服务&#xff0c;例如&#xff1a; WebRTC&#xff08;浏览器强制要求 HTTPS&#xff09;前端调用受限 API&#xff08;getUserMedia、Ser…

作者头像 李华
网站建设 2026/2/26 11:53:48

20、Linux 输入输出重定向、管道及文件归档操作指南

Linux 输入输出重定向、管道及文件归档操作指南 在 Linux 系统中，高效管理文件和数据是至关重要的。本文将详细介绍 Linux 中输入输出重定向、管道的使用以及文件归档的相关知识，这些技能能够帮助你更好地操作和管理系统中的文件和数据。 输入输出重定向 在 Linux 命令行操…

作者头像 李华