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

• DemoApplication.java：项目入口，包含 @SpringBootApplication 注解，启动 Spring Boot 应用；
• application.properties：配置文件，可设置端口、数据库连接等（也可使用.yml 格式）；
• pom.xml：管理项目依赖，Spring Boot 已内置父依赖，无需手动配置版本。

四、核心代码编写

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

DemoApplication.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 请求：

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 可修改端口、应用名等：

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

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

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

五、运行与测试项目

1. 启动项目

有两种启动方式：

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

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

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

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 格式）：

{
  "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）：

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

七、常见问题及解决

1. 端口被占用

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

2. 依赖下载慢

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

<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 插件：

<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 核心能力。