新版IDEA怎么创建Java 8 Spring Boot项目？三条可行路线全解析

Spring 官方抛弃 Java 8这事从 Spring Boot 3.0 发布那天起就成了无数后端老兵的意难平。尤其是最近两年 IntelliJ IDEA 更新越来越激进新建项目时默认给你生成 Spring Boot 3.xJava 版本直接锁定 17连下拉框里都看不到 Java 8。但老项目还在跑公司 JDK 还没升级教材、课设、旧文档又全是 Java 8 的写法。这篇文章就专门聊聊为什么 Spring 官方会放弃 Java 8以及在新版 IDEA 里到底有哪几条路能创建一个能跑、能编译、能维护的 Java 8 Spring Boot 项目。核心解法其实不复杂要么用老版本 Spring Boot 2.7.18 配合 JDK 8要么在 IDEA 里手动切初始化器和 SDK。难的是很多人第一步就走歪了——选择了新版 Spring Boot 3.x然后强行把 pom 里的 java.version 改成 1.8结果一大堆兼容性错误扑面而来。下面我把版本关系、创建步骤、环境配置和排查清单一次性讲透。1. Spring Boot 和 Java 8版本对应关系与背后的逻辑1.1 一张表看明白 Spring Boot 与 Java 版本的对应关系先说结论Spring Boot 2.7.x 是官方最后一个支持 Java 8 的版本线而 Spring Boot 3.x 及以后的版本最低要求是 Java 17。这不是官方“懒得优化”而是整个 Spring Framework 6 的基线都抬高了。Spring Boot 版本底层 Spring Framework最低 Java 版本是否支持 Java 8说明1.xSpring 4Java 6支持太久远不建议使用2.0 ~ 2.4Spring 5.xJava 8支持经典时代Java 8 很舒服2.5 ~ 2.6Spring 5.3.xJava 8支持开始要求部分新特性2.7.xSpring 5.3.xJava 8支持最后一个支持 Java 8 的版本线3.0 ~ 3.4Spring 6.xJava 17不支持全面迁移到 Jakarta EE 94.x后续版本Spring 7可能是 17 或 21不支持以官方发布为准这里最容易被忽略的是 2.7 的“尽头”。Spring Boot 2.7.18 是整个 2.x 的最后一个公共版本官方 OSS 免费维护期到 2023 年底已经结束。也就是说如果你出于业务限制必须用 Java 8那你实际可选的 Spring Boot 版本就是 2.7.18没有更新且有额外安全补丁需求的版本了。不过对于学习、内网业务系统、课设项目来说2.7.18 依然完全够用且稳定。1.2 官方为什么非要“抛弃” Java 8很多人的第一反应是“Spring 故意折腾人”但站在框架维护者的角度这个决策完全是理性的。Java 8 是 2014 年发布的版本到现在已经有十几年了。Spring Framework 6 想要使用 Java 17 带来的现代化语言特性比如record类型、sealed class、增强的switch模式匹配、新的字符串块以及instanceof模式变量。这些特性能让框架内部代码更简洁也让使用者写出来更安全。说白了框架要向前走就必须和旧语言版本切割。另一个更现实的原因是 javax 到 jakarta 的迁徙。Java EE 在 2019 年改名成 Jakarta EE命名空间从javax.*改为jakarta.*。Spring Boot 3 直接基于 Jakarta EE 9/10 构建这导致它在代码结构上和 Java 8 时代完全不再兼容。因此就算你再喜欢 Java 8新版 Spring Boot 的接口设计里也已经没有它的位置了。还有一个容易被忽略的事实Spring Boot 是一个庞大的依赖整合器它统一管理上百个三方库的版本。如果还要向下兼容 Java 8意味着 Tomcat、Netty、Jackson、Hibernate 等所有组件都得长期维护两套编译要求。这对一个追求长期演进的开源项目来说太重了。官方选择 Java 17 作为新基线等于给整个生态划了一条清晰的分界线——后续所有新组件、新能力都只围绕现代 JDK 做优化。理解了上面这些你就知道“新 IDEA 默认 Spring Boot 3.x”不是 IDEA 的问题而是官方的选择。你要做的不是硬刚新版 Spring Boot而是用正确的方式创建 Java 8 项目。2. 新版 IDEA 创建 Java 8 Spring Boot 项目的三条可行路线2.1 路线一换初始化源用阿里云 Spring Initializr 生成 2.7.18这是最省事的办法。IntelliJ IDEA 新建项目时自带的 Spring Initializr 默认指向https://start.spring.io但这个官方源现在只会生成基于 Spring Boot 3.x 的模板不会给你 Java 8 的机会。打开 IDEA点击New Project左侧选择Spring Boot窗口里有一个Server URL或Service URL输入框。默认值是https://start.spring.io你把它改成阿里云的初始化地址https://start.aliyun.com然后点击旁边的Refresh按钮让它重新拉取项目模板。此时下方Spring Boot版本下拉框就会出现 2.7.x 的选项比如2.7.18。同时右侧的Java版本下拉框也能选择8。选好 Group、Artifact点击 Create 就能生成项目。需要注意三个细节阿里云 Initializr 的版本列表不一定和官方完全同步但 2.7.18 这种经典版本长期都在部分新版 IDEA 在左侧生成器列表里可能显示为Spring Initializr没关系操作入口一致生成成功后项目默认的 Maven 配置文件依然是从spring-boot-starter-parent2.7.18 开始的后续无需再手动改版本。这条路适合从零开始、不想手动敲 pom 的开发者。唯一的小缺点是你的项目要依赖阿里云镜像仓库来拉取 Maven 依赖如果公司内网环境禁用了外网后续还需要调整settings.xml里的仓库地址。2.2 路线二手动创建 Maven 项目再引入 Spring Boot 2.7.18最推荐如果你已经装了新版 IDEA但不想折腾初始化源的刷新或者公司网络根本访问不了 start.aliyun.com那手动建 Maven 项目是更稳的方案。整个过程不会超过五分钟而且每一步你都能看清发生什么。先新建一个普通的 Maven 项目New Project选择Maven不勾选任何脚手架选项直接 Create。创建后打开根目录下的pom.xml把它全部删掉替换成下面这份?xml version1.0 encodingUTF-8? project xmlnshttp://maven.apache.org/POM/4.0.0 xmlns:xsihttp://www.w3.org/2001/XMLSchema-instance xsi:schemaLocationhttp://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd modelVersion4.0.0/modelVersion parent groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-parent/artifactId version2.7.18/version relativePath/ /parent groupIdcom.example/groupId artifactIdjava8-demo/artifactId version1.0.0/version namejava8-demo/name descriptionJava 8 Spring Boot Demo/description properties java.version1.8/java.version maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties dependencies dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-web/artifactId /dependency dependency groupIdorg.springframework.boot/groupId artifactIdspring-boot-starter-test/artifactId scopetest/scope /dependency /dependencies build plugins plugin groupIdorg.springframework.boot/groupId artifactIdspring-boot-maven-plugin/artifactId /plugin /plugins /build /project这里有几个关键的“为什么”需要解释一下。parent用了spring-boot-starter-parent版本固定为2.7.18。这个 parent 会自动帮你管理 Spring Boot 下一大堆依赖的版本号比如 Tomcat、Jackson、Spring Web MVC 等。你只需要在dependencies里声明spring-boot-starter-web不用写具体版本Maven 会根据 parent 的 dependencyManagement 自动拉取正确版本。java.version必须和maven.compiler.source、maven.compiler.target同时对得上。java.version是 Spring Boot 自己识别并传给 Maven 编译插件的参数后两个是 Maven 编译插件读取的字节码版本。如果这三个不一致就会出现 IDEA 显示 JDK 8 但编译时报Invalid target release: 17的怪问题。保存 pom 后IDEA 右下角会出现 Maven 刷新提示点击Enable Auto-Import或者手动点一下 Maven 工具窗里的刷新按钮让依赖下载完成。接下来创建主启动类。在src/main/java/com/example/demo目录下新建DemoApplication.javapackage com.example.demo; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; SpringBootApplication public class DemoApplication { public static void main(String[] args) { SpringApplication.run(DemoApplication.class, args); } }这就算完成了。运行主类控制台出现 Spring Boot 启动 banner说明项目彻底跑通。这条路比路线一多几步但好处是你完全知道自己在干什么。之后遇到任何版本或依赖问题都知道去 pom 里改而不是依赖图形界面。2.3 路线三直接用已有 Java 8 项目模板复制改造如果你手头有一个旧项目是 Spring Boot 2.7.x 的那最简单的办法就是拿它当模板复制一份改一下groupId、artifactId、服务名和包名。具体操作把整个项目文件复制到一个新目录用 IDEAOpen打开这个文件夹手动改pom.xml里的artifactId和包名再刷新 Maven。这种方式特别适合团队内部模板统一、多人协作的场景。相比从初始化源生成它最大的好处是可以连项目的目录结构、依赖版本、配置习惯一起继承下来避免新项目因为“看着太干净”而缺一堆公共依赖。需要注意复制改造时要清掉旧项目里的.idea目录和.iml文件否则 IDEA 可能会读出一堆旧配置导致 SDK 和 Maven 设置混乱。3. IDEA 环境配置细节多一个设置不对项目就起不来很多人在创建项目时选了 Java 8但项目一运行就报 Java 17 的错误原因就是 IDEA 里有几个 JDK 相关配置是分开的必须全部统一。3.1 Project SDK 和 Language Level 必须同步设置打开菜单File - Project Structure或者快捷键Ctrl Alt Shift S左侧选Project。右侧能看到两个关键项SDK这里必须选择1.8。如果列表里没有 1.8点击Add JDK找到你本机安装的 JDK 8 的安装目录macOS 是/Library/Java/JavaVirtualMachines/.../Contents/HomeWindows 则是C:\Program Files\Java\jdk1.8.0_xxx。Language level必须选择8 - Lambdas, type annotations etc.。这两个配置决定了 IDEA 在编辑器层面的代码解析规则。如果你只改了 SDK 却忘了改 Language levelIDEA 会提示某些 Java 8 语法不支持或者反过来Language level 是 17 但 SDK 是 8 时会直接标红。3.2 Maven 导入器和运行器也要指向 JDK 8IDEA 构建 Maven 项目时使用的是 Maven 运行环境而这个环境跟 Project SDK 是两套体系。进入File - Settings - Build, Execution, Deployment - Build Tools - Maven重点检查两个 tabImporting页下的JDK for importer选 1.8。这个用于 Maven 项目导入阶段解析 pom.xml 和依赖索引如果这里设置了 17Maven 在构建时会去读 JDK 17 的 api 高度容易导致编译错误。Runner页下的JRE也选 1.8。这个是在 IDEA 里直接点运行按钮启动 Spring Boot 项目时实际用于执行java命令的 JRE 环境。此外如果你的电脑装了多个 JDK还要看一眼系统环境变量JAVA_HOME是否指向 JDK 8。很多情况下Maven 命令或 IDEA Terminal 里执行java -version显示的是 17但项目还能跑因为 IDEA 内部运行使用 Runner 的设置但如果要用 mvn 命令行打包冲突就很明显了。3.3 Compiler 设置里的字节码版本还有一个容易被忽略的地方File - Settings - Build, Execution, Deployment - Compiler - Java Compiler。在Target bytecode version里对应模块要选择8。有些情况下IDEA 会默认显示17即使 pom.xml 里已经设置了java.version1.8。这是因为 IDEA 会优先按模块的 Project Structure 配置展示而不会完全跟随 Maven 的 properties。因此如果编译报错就去这里手动改为 8。建议同时在 pom.xml 里增加properties java.version1.8/java.version maven.compiler.source1.8/maven.compiler.source maven.compiler.target1.8/maven.compiler.target /properties这样 Maven 命令行构建时即使 IDEA 设置没跟上编译也能通过。IDE 有时候是“懒”的它倾向于显示自己缓存过的配置手动纠正一次之后再 Maven Reload 基本就稳了。4. 常见报错与排查清单实录下面这些报错和解决方案全部是我在帮同事创建 Java 8 Spring Boot 项目时踩过的真实场景整理成速查表遇到问题直接对号入座。报错现象根本原因解决方法Error: java: invalid source release: 17IDEA 的 Language level 或 Maven compiler 用了 17在 Project Structure 里把 SDK 和 Language level 都改成 8再同步 Maven settingsError: java: invalid target release: 17Maven 编译插件读取的是 17 的字节码版本修改 pom.xml 中maven.compiler.target为 1.8并刷新 MavenUnsupportedClassVersionError: unsupported class file major version 61运行时的 JRE 是 17但项目依赖编译成 8 字节码确保 IDEA Runner JRE 和命令行 JAVA_HOME 指向 JDK 8程序包 javax.servlet 不存在项目实际用的是 Spring Boot 3.x它迁移到了 Jakarta 命名空间回退 Spring Boot 版本到 2.7.18并把 pom 中的依赖命名空间改为 javax程序包 jakarta.servlet 不存在项目是 Spring Boot 2.7.x但代码里引用了 jakarta 开头的包全部改用javax.servlet开头的包Spring Boot 2.7 时期没有 jakartaIDEA 新建项目时 Spring Boot 版本下拉框中只有 3.xIDEA 的初始化 URL 指向官方 start.spring.io换成https://start.aliyun.com或手动修改 pom 到 2.7.18Maven 依赖下载失败或者非常缓慢本地仓库缓存损坏或者 Maven 中央仓库网络不稳定在${user.home}/.m2/settings.xml配置阿里云公共仓库镜像再 Reimport项目能编译但启动时报No active profile set这是提示不是报错但容易被误认可忽略如果不想看到提示在application.yml里设置spring.profiles.activedev单独展开几个最常见的坑。第一个是“IDEA 里能运行但用命令行mvn spring-boot:run就报错”。这种通常是因为命令行环境变量JAVA_HOME指向了 JDK 17但 IDEA 的配置是 JDK 8。解决方法是在项目的 Maven Runner 里配置Environment variables显式写上JAVA_HOMEC:\Program Files\Java\jdk1.8.0_xxxmacOS 则写上对应的 JDK 8 Home 路径。这样才能保证 IDEA 内置终端和命令行行为一致。第二个是“Spring Boot 2.7 项目里用 Lombok 报错”。Lombok 的版本需要跟 JDK 匹配。Java 8 环境下尽量在 pom 中显式声明一个兼容版本例如properties lombok.version1.18.30/lombok.version /properties不同版本 Lombok 对 JDK 的支持范围不同如果报Unable to make field accessible或The version of the Java错误优先降低 Lombok 版本而不是升级 JDK 版本。第三个是“为什么我明明选择了 2.7.18生成后却出现了jakarta.*的依赖”。这种情况多半是因为你项目里后来又手动加了其他依赖比如某些第三方库已经升级到 Spring Boot 3 兼容版且会强制传递引入 jakarta 相关包。排查方法是在 Maven 工具窗里运行mvn dependency:tree查清楚是谁把版本带上来。把那个依赖降级到 Spring Boot 2.7 兼容版本即可。第四个是“编译过了但运行又报ClassNotFound: javax.xml.bind”。Spring Boot 2.7 本身不会报这个问题但如果你在 pom 中显式添加了某些组件可能自动引入了较新的 JAXB 版本。Java 8 自带 JAXB但新版本 JAXB 已经迁移到 jakarta 包导致运行时找不到类。解决方案是锁定 JAXB 相关依赖版本到 2.3.x或者直接删掉不需要的 JAXB 依赖。5. 关于 Java 8 Spring Boot 项目的后续维护建议5.1 依赖版本能锁就锁别让 Maven 悄悄升级Java 8 Spring Boot 2.7.18 的项目最怕的不是编译失败而是某一天某个依赖因为“没写版本号”被 Maven 解析成了更高版本。虽然 Spring Boot 的 parent 会锁定大部分核心依赖的版本但第三方 starter 不会帮你锁。我的习惯是在 pom.xml 中把核心依赖都显式检查一遍至少做到mvn dependency:tree能对上预期版本。对于没有版本号显得“很干净”的 pom看上去省事实际是埋雷。特别是在有多个子模块的项目里稍不注意就出现传递依赖冲突。5.2 升级与不升级的权衡如果你的目标是学习那就用 Java 8 Spring Boot 2.7.18先熟悉 MVC、自动配置、Bean 生命周期这些核心概念。如果目标是想跟上新项目的架构比如 Spring Security 6、Spring AI、GraalVM native image那就必须切到 JDK 17 加 Spring Boot 3.x。Java 8 在 Spring 生态里已经被砍断了后续能力这不是危言耸听。如果你是维护老系统我建议至少把 JDK 升到 17、Spring Boot 升到 3.x 当作一个中期规划。第一步可以先只在测试环境跑通升级等到所有兼容性问题都解决后再推到生产。升级的难度主要不在代码量而在于三方框架版本、配置文件调整、命名空间替换这些琐碎事但这部分工作是一次性的。5.3 最后说点个人感受我做 Java 项目这些年Java 8 是很多人入门的第一个难跨的坎也是不少公司“最稳定”的部署环境。新版 IDEA 默认不给 Java 8并不意味着我们做不了 Java 8 项目只是想清楚版本背后的逻辑之后你会主动选择合适的工具而不是被迫接受默认值。我建任何新项目时都会先问一句“跑在哪个 JDK 上”再决定用哪个 Spring Boot 版本。环境和依赖的统一比“写多么高级的代码”重要得多。如果你正在折腾 Spring Boot Java 8希望这篇能让你少走几趟弯路。