SpringBoot环境搭建教程详解

一分耕耘，一分收获！既然打开了这篇文章《SpringBoot环境搭建步骤详解》，就坚持看下去吧！文中内容包含等等知识点...希望你能在阅读本文后，能真真实实学到知识或者帮你解决心中的疑惑，也欢迎大佬或者新人朋友们多留言评论，多给建议！谢谢！

Spring Boot项目需严格匹配JDK与版本：JDK 17适配2.7.x（稳定）或3.x（需Jakarta EE 9+），JDK 8仅支持2.5.x及更早；application.yml与.properties不可共存，YAML须UTF-8无BOM、缩进准确；Maven需确保中央仓库未被私有仓库屏蔽。

用IDEA创建Spring Boot项目时，spring-boot-starter-parent 版本选不对会直接导致依赖冲突

Spring Boot 项目必须通过 spring-boot-starter-parent 统一管理依赖版本，否则手动引入 spring-boot-starter-web 等 starter 会出现 ClassNotFoundException 或 NoClassDefFoundError。IDEA 内置的 Spring Initializr 默认推荐最新稳定版（如 3.2.0），但如果你本地 JDK 是 17，就不能选 Spring Boot 3.x —— 它要求 JDK 17+ 且默认启用 Jakarta EE 9+ 命名空间（jakarta.servlet 而非 javax.servlet）。

• JDK 17 + Spring Boot 3.x → 可用，但需确认所有第三方库已适配 Jakarta EE 9+
• JDK 17 + Spring Boot 2.7.x → 兼容性最稳，javax.* 包仍可用，适合老项目迁移过渡
• JDK 8 → 只能选 Spring Boot 2.5.x 或更早（2.6+ 已弃用 JDK 8 支持）

创建项目前务必在 IDEA 的 New Project → Spring Initializr 页面右下角点开 Switch to the full version，手动指定 Project SDK 和 Spring Boot Version，别信“Recommended”。

application.properties 和 application.yml 不能共存，且加载顺序影响配置生效

Spring Boot 启动时会按固定顺序扫描配置文件：application.properties 和 application.yml 若同时存在，.properties 会先被加载，但 .yml 不会覆盖它 —— 两者是独立解析的，最终合并行为不可控，极易引发配置静默失效。

• 只保留一个：推荐用 application.yml，缩进敏感但结构清晰，尤其适合多环境配置（spring.profiles.active: dev）
• 若用 application.properties，注意等号前后不能有空格：server.port=8080 ✅，server.port = 8080 ❌（部分旧版 Spring Boot 会忽略）
• 自定义配置文件（如 application-dev.yml）必须配合 spring.profiles.active=dev 才生效，光放文件没用

运行时报 Failed to load property source from location 'classpath:/application.yml' 多半是编码或缩进问题

YAML 对空格极其敏感，application.yml 文件本身编码为 UTF-8 无 BOM 是硬性要求。Windows 记事本保存的 .yml 文件常带 BOM，会导致 Spring Boot 解析失败；VS Code 或 IDEA 默认保存为 UTF-8 无 BOM，但若手动粘贴过含中文注释，可能混入全角空格或不可见字符。

检查方法：用 xxd 或 VS Code 的 “Show All Characters” 功能查看是否有多余空格、制表符（^I）、全角冒号（：）或 BOM（EF BB BF 开头）。

server:
  port: 8080
spring:
  profiles:
    active: dev
# 正确：2个空格缩进，英文冒号，无 tab，无 BOM

Maven 仓库里拉不到 spring-boot-dependencies？检查 settings.xml 是否屏蔽了中央仓库

Spring Boot 的 parent POM（如 spring-boot-starter-parent）本身不包含代码，只声明依赖管理（），其父 POM spring-boot-dependencies 必须从 Maven 中央仓库下载。国内很多公司私有 Nexus 仓库会关闭对 https://repo.maven.apache.org/maven2/ 的代理，导致 mvn clean compile 卡在 Downloading from central: https://repo.maven.apache.org/maven2/org/springframework/boot/spring-boot-dependencies/... 并超时。

• 临时解决：在项目根目录执行 mvn clean compile -Dmaven.repo.local=./mvn-repo 强制走本地缓存（前提是之前成功构建过）
• 长期方案：修改 ~/.m2/settings.xml，确保 配置中 * 不拦截 central，或显式添加中央仓库 profile：

<profile>
  <id>central</id>
  <repositories>
    <repository>
      <id>central</id>
      <url>https://repo.maven.apache.org/maven2/</url>
    </repository>
  </repositories>
</profile>

真正卡住的往往不是技术步骤，而是 JDK 版本和 Spring Boot 版本的隐式绑定、YAML 缩进这种肉眼难辨的细节，以及公司内部 Maven 仓库策略这种外部约束——这些地方出问题，错误日志不会直说，只会报一堆无关的 ClassNotFoundException。

好了，本文到此结束，带大家了解了《SpringBoot环境搭建教程详解》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！