使用IntelliJ IDEA搭配JDK 8编译执行Java程序时出现构建失败报错

阿华AIGC实验室

2026-4-2

IntelliJ IDEA搭配JDK 8编译执行Java程序时出现构建失败报错

我之前也碰到过一模一样的问题，其实原因很清晰：--add-modules是Java 9及以上版本模块化系统才引入的编译参数，JDK 8根本不支持这个参数，所以问题肯定是IntelliJ的项目配置里不小心混入了这个高版本专属的参数。下面是一步步排查解决的方法：

1. 先核对项目的SDK和语言级别配置

这是最常见的根源，确保整个项目从根到模块都统一用JDK 8的配置：

打开 File → Project Structure（快捷键：Ctrl+Alt+Shift+S）
切换到「Project」标签页：
- 确认「Project SDK」选择的是你的JDK 1.8版本
- 「Project language level」选「8 - Lambdas, type annotations etc.」（必须和JDK 8匹配）
再切换到「Modules」标签页：
- 选中每个模块，在「Sources」标签页里把「Language level」也设为8，和项目级别保持一致

2. 清除编译器的额外命令行参数

有时候IntelliJ会残留高版本JDK的编译参数：

打开 File → Settings → Build, Execution, Deployment → Compiler → Java Compiler
在「Additional command line parameters」输入框里，如果看到--add-modules相关的内容，直接删除
同时检查每个模块的「Per-module bytecode version」，确保「Target bytecode version」都是1.8

3. 检查构建工具（Maven/Gradle）的配置

如果你的项目用了Maven或Gradle，构建脚本里的配置也可能带了这个参数：

针对Maven项目

打开项目根目录的pom.xml，找到maven-compiler-plugin的配置，确保source和target都设为1.8，且没有添加--add-modules的参数：

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.8.1</version>
    <configuration>
        <source>1.8</source>
        <target>1.8</target>
        <!-- 这里如果有<compilerArgs>带--add-modules，直接删掉整个参数行 -->
    </configuration>
</plugin>

修改后记得点击IntelliJ右上角的「Reload All Maven Projects」按钮同步配置。

针对Gradle项目

打开build.gradle（或build.gradle.kts），确保sourceCompatibility和targetCompatibility都设为1.8：

plugins {
    id 'java'
}

sourceCompatibility = 1.8
targetCompatibility = 1.8

// 检查有没有类似下面的代码，有的话删掉
// compileJava {
//     options.compilerArgs += ['--add-modules', 'xxx']
// }

修改后点击「Reload Gradle Project」同步配置。