Spring Boot入门（快速搭建第一个项目，新手零配置）

wwwin217

369人浏览 · 2026-03-05 17:20:52

wwwin217 · 2026-03-05 17:20:52 发布

Spring Boot是Java后端开发的主流框架，简化了Spring的繁琐配置，实现“开箱即用”，但很多新手觉得Spring Boot配置复杂、门槛高，不敢上手。其实用Spring Initializr搭建Spring Boot项目，5分钟就能跑通第一个接口，零复杂配置！

今天分享Spring Boot的入门步骤——从搭建项目到编写第一个接口，每一步都有详细截图和代码，新手跟着操作，轻松跑通第一个Spring Boot项目～

一、准备工作：环境要求

JDK：8及以上（推荐1.8）；
IDE：IntelliJ IDEA（推荐，自带Spring Boot插件）；
构建工具：Maven/Gradle（本文用Maven）。

二、第一步：用Spring Initializr创建项目

1. 打开IDEA，点击「New Project」→ 选择「Spring Initializr」→ 点击「Next」。

2. 填写项目基本信息：

Name：项目名（如spring-boot-demo）；
Group：组织名（如com.example）；
Artifact：项目标识（如demo）；
Package name：包名（自动生成，无需改）；
Java Version：选择8；
点击「Next」。

3. 选择依赖（仅选Web即可）：

搜索「Spring Web」→ 勾选 → 点击「Next」。

4. 选择项目保存路径 → 点击「Finish」，IDEA会自动下载依赖（等待几分钟，首次下载较慢）。

三、第二步：项目结构解析（新手必懂）

创建完成后，项目核心结构如下：


spring-boot-demo/
├── src/main/java/com/example/demo/
│   ├── DemoApplication.java  // 项目启动类（核心！）
│   └── controller/           // 控制器（写接口的地方，手动创建）
├── src/main/resources/
│   ├── application.properties  // 配置文件（默认空，新手无需改）
└── pom.xml  // 依赖配置（自动生成）

DemoApplication.java：包含main方法，是项目的启动入口；
application.properties：全局配置文件（如端口、数据库配置）；
pom.xml：Maven依赖配置（Spring Web依赖已自动添加）。

四、第三步：编写第一个接口（核心！）

1. 手动创建controller包，在包下创建HelloController.java：


package com.example.demo.controller;

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

// 标记为控制器，返回JSON数据（无需视图解析）
@RestController
public class HelloController {

    // 定义GET请求，路径为/hello
    @GetMapping("/hello")
    public String hello() {
        return "Hello Spring Boot! 新手也能轻松入门～";
    }
}

2. 代码说明：

@RestController：组合注解（@Controller + @ResponseBody），表示这是一个控制器，且返回值直接作为响应体（JSON/字符串）；
@GetMapping("/hello")：映射GET请求，访问路径为/hello；
方法返回字符串，会直接显示在浏览器中。

五、第四步：启动项目并测试接口

1. 启动项目：

找到DemoApplication.java，右键点击「Run DemoApplication」，控制台出现以下日志，说明启动成功：


Started DemoApplication in 2.531 seconds (JVM running for 3.124)

（默认端口8080，可在application.properties中修改：server.port=8081）

2. 测试接口：

打开浏览器，访问http://localhost:8080/hello，页面显示：


Hello Spring Boot! 新手也能轻松入门～

恭喜！第一个Spring Boot接口运行成功～

六、进阶：编写带参数的接口

修改HelloController，添加带参数的接口：


@GetMapping("/user")
public String getUser(String name, Integer age) {
    return "姓名：" + name + "，年龄：" + age;
}

访问http://localhost:8080/user?name=张三&age=20，页面显示：


姓名：张三，年龄：20

七、新手避坑指南

启动报错「Port 8080 was already in use」：端口被占用，修改application.properties中的server.port（如8081）；
依赖下载慢：在pom.xml中添加阿里云Maven镜像（百度搜“阿里云Maven镜像”，复制到pom.xml的中）；
接口访问404：检查包结构（controller必须在DemoApplication的同级/下级包下）；
注解写错：@RestController不要写成@Controller（否则返回视图名，不是字符串）。