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

Ne0inhk

— 7 min read

前言

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 核心能力。如果本文对你有帮助，欢迎点赞收藏，有疑问可在评论区交流～

Read more

【亲测免费】 Western Digital SSD Dashboard v4.2.2.5 离线版

Western Digital SSD Dashboard v4.2.2.5 离线版 【下载地址】WesternDigitalSSDDashboardv4.2.2.5离线版Western Digital SSD Dashboard v4.2.2.5 离线版是一款功能强大的SSD管理工具，专为Western Digital SSD用户设计。无需网络连接，即可实时监控SSD的健康状况、温度和使用情况。支持一键式固件更新，确保SSD始终运行在最佳状态。内置性能测试功能，可快速检测读写速度，并提供系统优化建议，帮助提升整体性能。操作简单，只需下载解压后运行应用程序，即可轻松管理您的SSD。此工具集为用户提供了极大的便利，确保SSD的稳定性和高效运行，是Western Digital SSD用户的理想选择。 项目地址: https://gitcode.com/Premium-Resources/fb48a Western Digital

By Ne0inhk

Git小白必看：Checkout -b命令图解指南

快速体验 1. 打开 InsCode(快马)平台 https://www.inscode.net 2. 输入框内输入如下内容： 开发一个交互式Git学习工具，专门讲解git checkout -b命令。包含：1) 可视化分支图演示命令效果，2) 分步骤交互式练习，3) 常见错误模拟和纠正，4) 简单项目实战场景，5) 学习进度跟踪。界面友好，使用大量动画和图示，适合完全没有Git基础的用户。 1. 点击'项目生成'按钮，等待项目生成完整后预览效果 作为一个刚接触Git的小白，我最初看到git checkout -b这个命令时完全一头雾水。经过一段时间的学习和实践，终于搞明白了它的妙用，今天就来分享一下我的学习心得。 1. 什么是git checkout -b？ 简单来说，这个命令可以让你一步完成两件事：

By Ne0inhk
除夕夜，国产顶流压轴上线，QWEN3.5多模态开源！

除夕夜，国产顶流压轴上线，QWEN3.5多模态开源！

除夕夜，老金我刚咬了一口韭菜鸡蛋饺子。 手机"叮"的一声，弹出个通知。 老金我瞄了一眼——Qwen3.5，上线了。饺子差点没喷出来。 赶紧打开 chat.qwen.ai，两个模型直接挂在上面，可以用了。 阿里这帮人，大年三十放大招，连个发布会都没开，就这么安安静静地把东西甩出来了。 老金我放下筷子，扒了一晚上代码和文档，确认了一件事： 这不是小版本迭代，这是架构级别的重构。 先说结论：Qwen3.5到底升级了什么 根据老金我除夕夜扒的HuggingFace代码库、阿里云官网和chat.qwen.ai的实际体验，帮你梳理了3个核心变化。 第一个：原生多模态。 注意，是"原生"，不是"拼接"。 Qwen3之前的多模态方案是语言模型+视觉模块的两段式架构。 Qwen3.

By Ne0inhk

Dify（Agent + RAG）指南：从安装到实战的开源 LLM 应用开发平台

Dify 完全指南：从安装到实战的开源 LLM 应用开发平台 摘要：本文详细介绍开源 LLM 应用开发平台 Dify 的完整使用流程，包括本地部署、API 配置、工作流编排、知识库管理，以及跨境电商客服和 Text2SQL 两个实战案例。 目录 1. Dify 简介 2. 本地部署指南 3. API 配置与集成 4. 自定义工具开发 5. 工作流类型详解 6. 知识库管理 7. 实战案例：跨境电商客服 8. 实战案例：Text2SQL 数据库查询 9. 网页集成方案 10. 总结与建议 1. Dify 简介 1.1

By Ne0inhk