Spring Boot入门教程：60分钟快速上手

大家好，我是掘金上的一名全栈工程师，毕业于某985高校。这几年带过不少零基础的同学入门后端开发，发现很多人一听到“Spring Boot”就望而却步，觉得它高深莫测。其实不然！我当初学的时候也是一头雾水，但只要方法对、步骤清，60分钟就能跑通第一个Spring Boot应用。

今天这篇教程，就是专门为完全零基础的朋友准备的。我们会用最通俗的语言、最简单的例子，带你从零搭建一个能运行的Java Web项目。即使你之前没写过一行Java代码，也能跟着一步步做出来！

📌 小提示：虽然标题提到“区块链”，但本文重点是Spring Boot入门。我会在文末简单说明为什么很多区块链项目（尤其是企业级）会用到Java和Spring Boot，帮你建立知识连接。

---

一、Spring Boot 是什么？能用来做什么？

想象一下你要开一家餐厅：

• 传统做法：你需要自己买锅碗瓢盆、招厨师、设计菜单、办理营业执照……非常繁琐。
• Spring Boot 做法：相当于你租了一个“智能厨房”，所有设备都配好了，你只需专注于做菜（写业务逻辑）！

Spring Boot 就是一个“开箱即用”的Java开发框架。它帮我们自动配置了Web服务器、数据库连接、安全设置等繁琐内容，让我们能快速开发Web应用、API接口、微服务等。

✅ 它适合做什么？

• 公司内部管理系统（如人事、财务系统）
• 手机App的后端接口
• 物联网设备的数据接收服务
• 甚至——区块链项目的后端服务层！（比如提供REST API给前端调用智能合约）

---

二、环境准备：5分钟搞定开发环境

1. 安装JDK（Java开发工具包）

Spring Boot基于Java，所以首先要安装JDK。

• 推荐版本：JDK 17（长期支持版，稳定）
• 下载地址：https://adoptium.net/
• 安装后打开终端，输入：

  java -version
  

  如果看到类似 openjdk version "17.0.12" 的输出，说明安装成功！

⚠️ 常见问题：
Q：我装了JDK但命令行找不到？
A：检查是否配置了环境变量 JAVA_HOME。Windows用户可搜索“配置环境变量”，Mac/Linux用户可将 export JAVA_HOME=/path/to/jdk 加入 ~/.bashrc 或 ~/.zshrc。

2. 安装IDE（集成开发环境）

推荐使用 IntelliJ IDEA Community（免费版）：

• 下载地址：https://www.jetbrains.com/idea/download/
• 安装后打开，选择“Create New Project”

💡 我当初学的时候用的是Eclipse，但IDEA对Spring Boot的支持更友好，强烈建议新手用IDEA！

3. 安装Maven（项目构建工具）

好消息：IDEA内置了Maven，无需单独安装！我们后续会通过图形界面操作。

---

三、核心概念：3个关键词搞懂Spring Boot

1. 依赖（Dependencies）

就像做菜需要食材，Java项目也需要“依赖库”。Spring Boot通过 pom.xml 文件管理依赖。

例如，要开发Web应用，只需添加：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

这行代码会自动引入Tomcat服务器、Spring MVC框架等所有必要组件。

2. 自动配置（Auto-configuration）

Spring Boot会根据你添加的依赖，自动配置相关功能。
比如你加了 spring-boot-starter-web，它就自动启动内嵌的Tomcat服务器，监听8080端口。

🎯 这就是“约定优于配置”——你不用写几百行配置，框架帮你搞定！

3. 控制器（Controller）

这是你写业务逻辑的地方。每个Controller负责处理特定的URL请求。

例如：

@RestController
public class HelloController {
    @GetMapping("/hello")
    public String sayHello() {
        return "Hello, Spring Boot!";
    }
}

访问 http://localhost:8080/hello 就能看到返回结果。

---

四、实战项目：手把手写一个“欢迎页面”

现在，我们来创建一个真正的Spring Boot项目！

步骤1：创建项目

1. 打开IDEA → New Project
2. 左侧选择 Spring Initializr
3. 填写：
   • Project SDK: 选择你安装的JDK 17
   • Language: Java
   • Group: com.example（公司或组织域名倒写）
   • Artifact: demo
4. 在 Dependencies 搜索框中输入 web，勾选 Spring Web
5. 点击 Finish

🔍 项目结构说明：

demo/
├── src/main/java/com/example/demo/DemoApplication.java  ← 主启动类
├── src/main/resources/application.properties           ← 配置文件
└── pom.xml                                           ← 依赖管理

步骤2：编写控制器

在 com.example.demo 包下新建一个Java文件 HelloController.java：

package com.example.demo;

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

@RestController
public class HelloController {

    @GetMapping("/welcome")
    public String welcome() {
        return "🎉 欢迎学习Spring Boot！你已经成功运行了第一个接口！";
    }

    // 新增一个返回JSON的例子
    @GetMapping("/user")
    public User getUser() {
        return new User("张三", 25);
    }

    // 内部类：代表用户数据
    static class User {
        private String name;
        private int age;

        public User(String name, int age) {
            this.name = name;
            this.age = age;
        }

        // Getter方法（IDEA可右键生成）
        public String getName() { return name; }
        public int getAge() { return age; }
    }
}

步骤3：启动项目

1. 找到 DemoApplication.java
2. 右键 → Run 'DemoApplication.main()'
3. 看到控制台输出：

   Tomcat started on port(s): 8080 (http)
   Started DemoApplication in 2.5 seconds
   

步骤4：测试接口

打开浏览器，访问：

• http://localhost:8080/welcome → 显示欢迎文字
• http://localhost:8080/user → 返回JSON：

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

✅ 恭喜！你已经完成了第一个Spring Boot应用！

---

五、常见问题解答（FAQ）

问题	原因	解决方案
启动时报错 Address already in use	8080端口被占用	在 application.properties 添加 server.port=8081 换端口
访问接口返回404	URL路径写错或Controller未被扫描	检查 @GetMapping 路径；确保Controller在主类同包或子包下
中文显示乱码	编码问题	在 application.properties 添加 server.servlet.encoding.charset=UTF-8
项目无法导入依赖	网络问题或Maven配置错误	在IDEA中点击 Reload All Maven Projects（右侧Maven面板）

💡 避坑指南：

• 不要把Controller类放在 src/test 目录下（那是测试代码）
• 修改代码后无需重启，IDEA会自动热加载（部分情况需手动编译）
• 初学者不要一上来就改 application.yml，先用 .properties 更简单

---

六、为什么区块链项目也会用到Java和Spring Boot？

你可能会疑惑：不是说区块链用Go、Rust更多吗？为什么还要学Java？

其实，在企业级区块链应用中，Java依然占据重要地位：

1. Hyperledger Fabric（Linux基金会项目）官方提供了Java SDK
2. 很多银行、供应链金融的区块链系统，后端用Spring Boot提供API给前端或移动端
3. Java生态成熟，适合开发复杂的业务逻辑（如权限管理、审计日志）

举个例子：你的Spring Boot应用可以：

• 调用Fabric网络提交交易
• 提供REST接口让App查询链上数据
• 与传统数据库（MySQL）协同工作

所以，掌握Spring Boot，等于拿到了进入区块链后端开发的一把钥匙！

---

七、下一步学习建议

完成本教程后，你可以：

1. 巩固基础

   • 学习Spring Boot如何连接数据库（尝试 spring-boot-starter-data-jpa + H2内存数据库）
   • 理解 @Autowired、@Service 等注解的作用

2. 动手扩展

   • 给你的 /user 接口加上参数（如 @RequestParam String name）
   • 尝试返回不同格式的数据（XML、自定义文本）

3. 进阶方向

   graph LR
   A[Spring Boot基础] --> B[Spring Security 安全控制]
   A --> C[MyBatis/Spring Data JPA 数据库操作]
   A --> D[Redis缓存集成]
   A --> E[部署到云服务器]
   

4. 探索区块链结合点

   • 学习Hyperledger Fabric Java SDK文档
   • 尝试用Spring Boot封装一个“上链”服务

---

结语

60分钟很短，但足够让你迈出后端开发的第一步。我当初也是从一个 Hello World 开始，一步步走到今天。技术没有捷径，但有正确的起点。

希望这篇教程能成为你的起点。如果遇到问题，欢迎在评论区留言——我看到都会回复！

最后送大家一句话：
“写代码不怕慢，就怕站。”
现在，去运行你的第一个Spring Boot应用吧！🚀