报错主因是IDEA启动JDK与项目所需JDK不一致或IDEA版本不支持所选JDK；需同步配置IDEA启动JDK（via .vmoptions）、项目SDK、模块SDK、构建工具（Maven/Gradle）及编译器目标版本，并清理缓存重启。
直接结论：这个报错几乎总是因为 IDEA 启动时用的 JDK 和项目编译/运行所需的 JDK 不一致，或者 IDEA 自身版本不支持你选的 JDK 版本。
检查 IDEA 启动用的 JDK（不是项目 SDK）
很多人只改了项目 SDK，却没注意 IDEA 自己是用哪个 JDK 启动的。IDEA 是 Java 应用，它自己也需要一个 JDK 来运行——这个 JDK 决定它能否加载、解析高版本字节码。
- Windows/macOS/Linux 都一样：打开
idea64.exe.vmoptions（Windows）或idea.vmoptions（macOS/Linux），路径在 IDEA 安装目录的bin/子目录下 - 确认文件里有类似
-Djava.home=/path/to/jdk-17或-XX:MaxRAMPercentage=75.0前面的-Xbootclasspath行是否指向了低版本 JDK（比如 jdk1.8） - 如果没显式指定
java.home，IDEA 会 fallback 到系统JAVA_HOME；此时运行echo $JAVA_HOME（Linux/macOS）或echo %JAVA_HOME%（Windows）看它指向哪 - 修改后必须重启 IDEA（不是重载项目），否则无效
验证 IDEA 版本与 JDK 的兼容性
IDEA 不是“支持任意 JDK”，每个大版本都有明确支持的 JDK 范围。比如 IDEA 2022.3 最高只支持到 JDK 19，而 JDK 21 的虚拟线程等特性在 IDEA 2023.2 才开始被完整识别。
- 查官方文档页：
https://www.jetbrains.com/idea/download/other.html→ 看 “System Requirements” 栏里的 “JDK version required” - 常见组合：IDEA 2023.1 支持 JDK 17–20；IDEA 2023.3+ 支持 JDK 17–21；IDEA 2024.2+ 支持 JDK 17–22
- 如果你硬要用 JDK 21 + IDEA 2022.3，即使项目能编译运行，也会频繁出现
Cannot resolve symbol或语法标红——这不是配置问题，是 IDE 本身解析器不认新语法 - 升级 IDEA 比降级 JDK 更可靠；尤其不要在旧版 IDEA 里强行加
--enable-preview参数应付新特性
统一四层 JDK 配置（避免“源 vs 目标”冲突）
报错信息如 java: 警告: 源发行版 17 需要目标发行版 17，说明至少有一层配置没对齐。这四层必须全部指向同一 JDK 版本：
-
构建工具层：Maven 项目看
pom.xml里的<maven.compiler.source>17</maven.compiler.source>和<maven.compiler.target>17</maven.compiler.target>；Gradle 项目看build.gradle中的sourceCompatibility = JavaVersion.VERSION_17和targetCompatibility = JavaVersion.VERSION_17 -
Project 结构层：File → Project Structure → Project →
Project SDK和Project language level都设为 17 -
Module 层：Project Structure → Modules → 选中模块 → Dependencies →
Module SDK必须和 Project SDK 一致（不能是 “Inherit project SDK” 但实际继承了个空值） -
编译器层：Settings → Build → Compiler → Java Compiler →
Target bytecode version设为 17；勾选Use compiler from module's SDK（不勾选就容易用错 javac）
清理缓存再试（别跳过）
IDEA 会缓存 SDK 路径、语言级别、类路径索引。改完配置不清理缓存，大概率还是报老错。
- 菜单栏 File →
Invalidate Caches and Restart…→ 选Invalidate and Restart - 不要选 “Just Restart”，那不会清缓存
- 重启后观察右下角是否弹出 “Loading project info…” —— 这表示索引正在重建，等它完成再点运行
- 如果仍失败，删掉项目根目录下的
.idea/文件夹（保留.iml和src/），重新 Import Project
最常被忽略的是 IDEA 自身启动 JDK 和构建工具配置之间的脱节——改完 pom.xml 却忘了改 idea.vmoptions，或者升级了 JDK 却没更新 JAVA_HOME。这两处一错，其他所有设置都白调。
