《Spring Boot 第一个 REST API 教程》

前置知识：Java 基础、Maven 基础
最终效果：启动一个 Spring Boot 应用，通过浏览器访问http://localhost:8080/hello得到{"msg":"Hello World"}

步骤 1：创建项目

推荐使用 Spring Initializr：

• 项目：Maven，语言：Java，Spring Boot 版本：3.2.x

• 依赖：Spring Web

• 生成并解压，用 IDEA 打开。

步骤 2：编写 Controller

在src/main/java/com/example/demo下新建HelloController.java：

java

package com.example.demo; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RequestMapping; import org.springframework.web.bind.annotation.RestController; @RestController @RequestMapping("/api") public class HelloController { @GetMapping("/hello") public String sayHello() { return "Hello World"; } }

注：@RestController表示返回的数据直接写入 HTTP 响应体（JSON 或纯文本）。

步骤 3：启动应用

运行主类DemoApplication（带有@SpringBootApplication）。
控制台出现Started DemoApplication in 2.5 seconds即成功。

步骤 4：测试接口

打开浏览器或 curl：

bash

curl http://localhost:8080/api/hello

输出：Hello World

步骤 5：返回 JSON（进阶）

修改方法，返回一个 Map 或自定义对象：

java

@GetMapping("/user") public Map<String, Object> getUser() { Map<String, Object> map = new HashMap<>(); map.put("name", "张三"); map.put("age", 25); return map; }

访问/api/user得到{"name":"张三","age":25}

常见问题

• 端口被占用：在application.properties中添加server.port=8081

• 404 错误：检查@RequestMapping前缀和@GetMapping路径是否一致