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，但若手动粘贴过含中文注释，可能混入全角空格或不可见字符。
你接手一个需求时，是不是经常这样："改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续"；这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境（JDK、Spring Boot、ORM、数据库、前端框架），记在
立即学习“Java免费学习笔记（深入）”；
检查方法：用 xxd 或 VS Code 的 “Show All Characters” 功能查看是否有多余空格、制表符（^I）、全角冒号（：）或 BOM（EF BB BF 开头）。
server:
port: 8080
spring:
profiles:
active: dev
# 正确：2个空格缩进，英文冒号，无 tab，无 BOMMaven 仓库里拉不到 spring-boot-dependencies？检查 settings.xml 是否屏蔽了中央仓库
Spring Boot 的 parent POM（如 spring-boot-starter-parent）本身不包含代码，只声明依赖管理（<dependencymanagement></dependencymanagement>），其父 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，确保<mirror></mirror>配置中<mirrorof>*</mirrorof>不拦截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。
