Spring Boot本身不依赖环境变量，真正需配置的是JAVA_HOME（必须）和MAVEN_HOME（可选），JDK版本须匹配Spring Boot要求（2.x用JDK 8/11，3.x用JDK 17+），Maven仅影响构建而非运行，项目配置通过application.properties/yml实现，不识别SPRING_BOOT_HOME等变量。
Spring Boot 本身不依赖环境变量——它跑在 JDK 上，真正要配好的是 JAVA_HOME 和（可选但推荐的）MAVEN_HOME。所谓“Spring Boot 环境变量设置不对”，90% 是混淆了 JDK、Maven 和 Spring Boot 的职责。下面直击关键点，帮你一次性理清。
JDK 环境变量必须正确
Spring Boot 应用启动前必须有可用的 Java 运行环境。如果 java -version 报错或显示版本异常，Spring Boot 根本不会启动。
- 确认已安装 JDK 8 或 11（Spring Boot 2.x 推荐 JDK 8/11；3.x 要求 JDK 17+）
- 设置 JAVA_HOME 指向 JDK 根目录（不是 JRE，也不是 bin 目录），例如：
C:\Program Files\Java\jdk-11.0.20 - 在 Path 中添加
%JAVA_HOME%\bin（注意：不是%JAVA_HOME%\jre\bin） - 打开新命令行窗口，运行
java -version和javac -version，两者输出一致且非错误信息才算成功
Maven 环境变量只影响构建，不影响运行
Spring Boot 启动 jar 包（java -jar xxx.jar）时完全不需要 Maven。只有你在 IDEA 或命令行里用 mvn spring-boot:run 启动，才需要 Maven 环境变量。
- 解压 Maven 后，设置 MAVEN_HOME 为解压路径（如
D:\tools\apache-maven-3.9.6），不含\bin - 在 Path 中添加
%MAVEN_HOME%\bin - 运行
mvn -v验证：能输出 Maven 版本、Java 版本、本地仓库路径，说明配置成功 - 若报 “不是内部或外部命令”，重点检查 Path 是否拼写错误、是否漏掉
%MAVEN_HOME%\bin、是否用了中文路径或空格路径（建议避免）
Spring Boot 项目本身不设环境变量
Spring Boot 的配置靠 application.properties 或 application.yml，以及启动参数（如 --spring.profiles.active=prod）。它不读取也不要求你设置类似 SPRING_BOOT_HOME 这类变量——这种变量根本不存在，设了也无效。
- 确保配置文件放在
src/main/resources/下，且命名为application.yml或application.properties（拼写一个字母错，比如applicaton.yml，配置就静默失效） - 多环境配置（如
application-dev.yml）需配合spring.profiles.active=dev才生效 - IDEA 中若用 Maven 构建，记得勾选 “Delegate IDE build/run actions to Maven” 并指定正确的
settings.xml路径
常见验证和排查动作
别靠猜，用这几步快速定位问题根源：
- 打开干净的 CMD（不是 PowerShell，也不是旧窗口），逐条执行：
echo %JAVA_HOME%→java -version→mvn -v（如有 Maven）→mvn clean compile（测试构建） - 启动失败时，第一眼盯日志最底部的
Caused by:行——是ClassNotFoundException？大概率是依赖或 JDK 版本问题；是BindException？端口被占；是ScannerException？YAML 缩进或冒号后缺空格 - Windows 下 YAML 文件若在 Linux 写完再拷贝过来，可能带 CRLF 换行符或 BOM 头，用 VS Code 或 Notepad++ 转成 UTF-8 无 BOM + LF 换行可避坑
