SpringBoot与Maven入门：Java开发环境搭建与项目创建-代码聚汇网

SpringBoot与Maven入门：Java开发环境搭建与项目创建

菩提流支·2026-08-17·阅读 22 GEO检测（免费）

SpringBootMavenJava开发

|难度：普通|阅读约 13 分钟

1. SpringBoot与Maven基础认知

第一次接触SpringBoot和Maven时，我完全被各种配置文件和依赖关系搞晕了。直到真正理解它们的设计哲学，才发现这套组合拳简直是Java开发的"瑞士军刀"。SpringBoot通过约定优于配置的原则，让开发者从繁琐的XML配置中解放出来；而Maven则像一位细心的管家，帮我们管理项目依赖和构建流程。

在主流Java企业开发中，这套技术栈几乎成为标配。根据2023年开发者调查报告，超过78%的Java项目采用SpringBoot框架，而Maven的市场占有率更是高达85%。这种组合之所以受欢迎，关键在于它们解决了传统JavaEE开发中的几个痛点：复杂的项目配置、依赖冲突、构建流程不统一等。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 开发环境准备

2.1 JDK安装与配置

工欲善其事，必先利其器。我推荐使用JDK 11作为开发环境，这是目前企业中最稳定的LTS版本。安装完成后，需要配置两个关键环境变量：

bash复制# Windows系统示例
JAVA_HOME=C:\Program Files\Java\jdk-11.0.15
PATH=%JAVA_HOME%\bin;...

验证安装是否成功：

bash复制java -version

注意：避免使用JDK 8以下版本，某些SpringBoot 2.7+的特性可能无法支持

2.2 Maven安装实战

从Maven官网下载最新稳定版（目前是3.8.6），解压后同样需要配置环境变量：

bash复制MAVEN_HOME=D:\apache-maven-3.8.6
PATH=%MAVEN_HOME%\bin;...

验证安装：

bash复制mvn -v

我强烈建议配置阿里云镜像仓库，可以大幅提升依赖下载速度。修改conf/settings.xml：

xml复制<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>*</mirrorOf>
  <name>阿里云公共仓库</name>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

3. 创建第一个SpringBoot项目

3.1 使用Spring Initializr

最快捷的方式是通过start.spring.io生成项目骨架。我习惯选择：

Maven项目
Java 11
Spring Boot 2.7.x
打包方式Jar
添加Spring Web依赖

下载解压后，项目结构如下：

code复制myproject
├── src
│   ├── main
│   │   ├── java
│   │   └── resources
│   └── test
└── pom.xml

3.2 手动创建Maven项目

如果你更喜欢从零开始，可以按以下步骤操作：

创建标准Maven项目结构
编辑pom.xml，添加SpringBoot父依赖：

xml复制<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.3</version>
</parent>

添加web starter依赖：

xml复制<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
</dependencies>

4. 核心配置文件解析

4.1 application.properties

SpringBoot的配置中心，我推荐使用YAML格式更清晰：

yaml复制server:
  port: 8080
  servlet:
    context-path: /api
    
spring:
  application:
    name: demo-service

4.2 pom.xml深度解读

Maven的核心配置文件需要特别关注几个部分：

依赖管理：

xml复制<dependencies>
    <!-- 生产环境依赖 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <!-- 开发工具 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-devtools</artifactId>
        <scope>runtime</scope>
        <optional>true</optional>
    </dependency>
</dependencies>

构建插件：

xml复制<build>
    <plugins>
        <plugin>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-maven-plugin</artifactId>
        </plugin>
    </plugins>
</build>

5. 开发第一个REST接口

5.1 创建主启动类

java复制@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(DemoApplication.class, args);
    }
}

5.2 编写控制器

java复制@RestController
@RequestMapping("/hello")
public class HelloController {
    
    @GetMapping
    public String sayHello() {
        return "Hello, SpringBoot!";
    }
    
    @GetMapping("/{name}")
    public String personalizedHello(@PathVariable String name) {
        return "Hello, " + name + "!";
    }
}

启动应用后，访问：

http://localhost:8080/api/hello
http://localhost:8080/api/hello/John

6. 项目构建与运行

6.1 Maven常用命令

bash复制# 清理并打包
mvn clean package

# 跳过测试打包
mvn clean package -DskipTests

# 运行SpringBoot应用
mvn spring-boot:run

6.2 打包可执行Jar

执行mvn package后，会在target目录生成两个jar文件：

demo-0.0.1-SNAPSHOT.jar（普通jar）
demo-0.0.1-SNAPSHOT.jar.original（原始jar）

使用java -jar运行：

bash复制java -jar target/demo-0.0.1-SNAPSHOT.jar

7. 开发中的实用技巧

7.1 热部署配置

添加devtools依赖后，在IDEA中开启自动构建：

Settings → Build → Compiler → 勾选Build project automatically
按Ctrl+Shift+A → Registry → 勾选compiler.automake.allow.when.app.running

7.2 日志配置

在application.yml中添加：

yaml复制logging:
  level:
    root: INFO
    org.springframework.web: DEBUG
  file:
    name: logs/app.log

7.3 跨域处理

java复制@Configuration
public class CorsConfig implements WebMvcConfigurer {
    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/**")
                .allowedOrigins("*")
                .allowedMethods("*")
                .maxAge(3600);
    }
}

8. 常见问题排查

8.1 依赖冲突解决

使用mvn dependency:tree查看依赖树：

bash复制mvn dependency:tree -Dincludes=com.fasterxml.jackson.core

排除特定依赖：

xml复制<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    <exclusions>
        <exclusion>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
        </exclusion>
    </exclusions>
</dependency>

8.2 端口占用问题

bash复制# Windows查看端口占用
netstat -ano | findstr 8080

# Linux/Mac
lsof -i :8080

8.3 启动时常见异常

Bean创建失败：检查@ComponentScan范围
数据库连接失败：检查application.yml配置
404错误：确认@RestController注解和@RequestMapping路径

9. 项目结构最佳实践

经过多个项目实践，我总结出以下推荐结构：

code复制src/main/java
├── com.example.demo
│   ├── config       # 配置类
│   ├── controller   # 控制器
│   ├── service      # 业务服务
│   │   ├── impl     # 服务实现
│   ├── repository   # 数据访问
│   ├── model        # 数据模型
│   │   ├── dto      # 数据传输对象
│   │   ├── entity   # 实体类
│   │   └── vo       # 视图对象
│   ├── exception    # 异常处理
│   └── util         # 工具类

10. 进阶学习建议

掌握基础后，可以继续深入：

SpringBoot自动配置原理
集成MyBatis/JPA实现数据访问
Spring Security安全配置
Actuator监控端点
分布式事务解决方案
Docker容器化部署

我个人的经验是，先动手实现一个完整的小项目（如用户管理系统），在实践中遇到问题再针对性学习，效果比单纯看文档要好得多。SpringBoot官方文档非常完善，遇到问题时首先查阅相关章节，往往能找到最佳实践。