IDEA中Maven项目不识别pom.xml，主因是未将含pom.xml的最外层文件夹设为项目根目录；需用“Open Project”而非“Open”，或通过Project Structure导入模块，并检查pom.xml是否被排除、语法是否正确。
IDEA里Maven项目不识别pom.xml，右键没“Add as Maven Project”选项
这通常不是Maven配置问题，而是IDEA没把当前目录当项目根——它压根没扫描到pom.xml。常见诱因是：你用“Open”而非“Open Project”打开文件夹，或项目结构里pom.xml不在最外层。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 关闭当前项目，重新选择 File → Open…，然后选中包含
pom.xml的**最外层文件夹**（不是子模块，也不是src目录） - 如果已打开，可尝试 File → Project Structure → Modules，点“+” → “Import Module”，再选中
pom.xml - 检查
pom.xml是否被IDEA标记为“excluded”：右键该文件 → “Mark as → Not Excluded” - 确认
pom.xml语法合法——哪怕一个错位的都可能导致IDEA静默跳过解析
Maven编译报错java.lang.UnsupportedClassVersionError，但JDK明明装了17
这个错误表面是Java版本不匹配，实际根源常在三处：IDEA的Project SDK、Maven Runner的JRE、以及pom.xml里maven-compiler-plugin的source/target配置，三者必须对齐。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 进 File → Project Structure → Project，确认“Project SDK”和“Project language level”都设为对应JDK（如17）
- 进 Settings → Build → Build Tools → Maven → Runner，检查“JRE”是否指向同一JDK（不是IDEA自带的JetBrains Runtime）
- 在
pom.xml中显式声明插件版本与目标字节码：
org.apache.maven.plugins maven-compiler-plugin 3.11.0 17 17
注意：--release 17，需确保JDK17+且Maven插件版本≥3.8.0
依赖下载失败，提示Could not transfer artifact ... from/to central
不是网络不通，就是Maven配置被本地settings.xml劫持了镜像或认证逻辑。IDEA默认用全局conf/settings.xml，但可能被公司私服或旧配置污染。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 先确认IDEA用的是哪个
settings.xml： Settings → Build → Build Tools → Maven → User settings file，勾选“Use settings file”并指定路径，或干脆用IDEA内置默认（留空）快速验证 - 临时禁用镜像：打开
settings.xml，注释掉所有central - 检查
- 命令行验证：在项目根目录运行
mvn dependency:resolve -U，看是否同样失败——排除IDEA缓存干扰
运行时找不到类，但mvn compile明明成功了
典型症状是IDEA里能编译通过，但点击绿色三角运行却报ClassNotFoundException或NoClassDefFoundError。根本原因是：IDEA的运行配置没把Maven依赖加进classpath，或者用了错误的“Runner”类型。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 右键类 → “Run ‘Xxx.main()’”前，先点右上角运行配置下拉箭头 → “Edit Configurations…” → 左侧选中该配置 → 右侧确认“Use classpath of module”指向的是你的主module（不是test module或父pom module）
- 检查“Runner”设置：同上配置页 → “Configuration”标签页 → “Environment variables”下方，确认“Include dependencies with “Provided” scope”是否勾选（多数情况需要）
- 如果用Spring Boot，别手动建Application类运行——应使用IDEA内置的Spring Boot Runner，否则
spring-boot-maven-plugin打包逻辑不会生效，嵌入式容器也起不来 - 删掉
target/和IDEA的.idea/misc.xml（备份后），重启IDEA强制重载Maven结构
最易被忽略的一点：模块间依赖若用pom.xml的
