Spring框架配置与项目搭建教程

本文深入浅出地讲解了Spring Boot项目初始化的核心要点，强调Spring项目配置的本质不是繁琐的环境搭建，而是精准选择起点——通过Spring Initializr一键生成标准化工程，正确声明spring-boot-starter-parent以统一依赖与插件、引入spring-boot-starter-web快速启用Web能力，并严格遵循启动类位于根包、配置文件置于src/main/resources且编码为UTF-8等关键规范，从而彻底规避XML配置、容器部署、版本冲突和组件扫描失效等经典陷阱，让开发者从第一行代码就踏上高效、稳定、现代化的Spring开发快车道。

Spring 项目初始化不是“配环境”，而是选对起点——用 spring-boot-starter-parent 和 spring-boot-starter-web 就能跳过 XML 配置、Servlet 容器部署、依赖版本冲突等老问题。

用 Spring Initializr 快速生成基础项目

手动建 Maven 工程再加一堆 dependency 容易漏掉 spring-boot-maven-plugin 或写错 parent，直接访问 https://start.spring.io：

• 选 Java 版本（建议 17+，Spring Boot 3.x 要求 JDK 17）
• 填 Group（如 com.example）、Artifact（如 demo）
• 勾选 Spring Web（替代旧版的 spring-webmvc）
• 生成 ZIP 解压后导入 IDE，mvn clean compile 能过就说明依赖和插件已就位

确认 pom.xml 的 parent 和关键 starter 是否正确

很多人复制旧项目配置，把 spring-boot-starter-parent 写成普通 parent 或漏掉 version，导致 @RestController 找不到或 SpringApplication.run() 启动失败。

<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-starter-parent</artifactId>
  <version>3.2.5</version>
  <relativePath/>
</parent>

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

注意：spring-boot-starter-parent 不是可选的——它统一管理依赖版本、默认插件配置（比如 spring-boot-maven-plugin），删掉它就得自己写 和 ，得不偿失。

启动类必须在 package 根路径下，否则组件扫描失效

@SpringBootApplication 默认只扫描该类所在包及其子包。如果启动类放在 com.example.config，而 @RestController 在 com.example.controller（同级），就不会被加载。

• 启动类命名建议为 Application.java，放在 com.example（即 Group ID 对应的最外层包）
• 不要把它塞进 config、util 这类子包里
• 若必须放别处，用 @SpringBootApplication(scanBasePackages = "com.example")

application.properties / application.yml 位置和常见坑

配置文件必须放在 src/main/resources/ 下，名字必须是 application.properties 或 application.yml（不能叫 app.properties 或大小写错误）。

常见低级错误：

• server.port=8080 写成 server.port = 8080（YAML 要求冒号后必须空格）
• spring.profiles.active=dev 写在 application-dev.properties 里（它不会自动激活自己，得写在主配置里）
• 中文注释用了 # 但文件编码不是 UTF-8（IDEA 默认是 UTF-8，Eclipse 可能是 GBK，导致乱码后配置失效）

启动时看控制台第一行：如果看到 Started Application in X seconds，说明配置加载成功；如果卡在 Tomcat started on port(s): 8080 之后没日志，大概率是 @RestController 没被扫到或端口被占。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。