Java 21如何消除预览特性的编译器警告？已尝试方法无效

问题说明 #

使用Java 21预览特性（如字符串模板）时，尝试两种方法仍无法消除编译器警告：

• 在Gradle构建文件中添加编译参数
• 在所有module-info.java文件中添加@SuppressWarnings("preview")注解

警告分为两类：

1. 代码中直接使用预览特性的提示（如字符串模板）
2. 依赖类文件使用预览特性的提示

已尝试的Gradle配置 #

tasks
        .withType(JavaCompile)
        .configureEach {
            java {
                sourceCompatibility = javaVersion
                targetCompatibility = javaVersion
                options.incremental = true
                options.encoding = 'UTF-8'
                options.compilerArgs += [
                        "--enable-preview",
                        "-Xlint:all",
                        "-Xlint:-preview"
                    ]
            }

        }

警告示例 #

.../DataLoader.java:373: warning: [preview] string templates are a preview feature and may be removed in a future release.
                            logger.log(SEVERE, STR."Error after \{sheet}/\{rowCounter[0]}, \{t}");
                                                   ^
.../DataLoader.java:373: warning: [preview] string templates are a preview feature and may be removed in a future release.
                            logger.log(SEVERE, STR."Error after \{sheet}/\{rowCounter[0]}, \{t}");

warning: [preview] class file .../Named.class) uses preview features of Java SE 21.
warning: [preview] class file for .../ExcelWorkbook$ExcelSheet.class uses preview features of Java SE 21.
warning: [preview] class file for ../Store.class) uses preview features of Java SE 21.
warning: [preview] class file for .../ExcelWorkbook$Field.class uses preview features of Java SE 21.

解决方案 #

1. 修正Gradle编译配置 #

原配置存在结构错误：java { ... }块不属于JavaCompile任务的配置范围，需直接在任务中配置编译选项。修改后的配置如下：

tasks.withType(JavaCompile).configureEach {
    sourceCompatibility = javaVersion
    targetCompatibility = javaVersion
    options.incremental = true
    options.encoding = 'UTF-8'
    options.compilerArgs.addAll([
        "--enable-preview",
        "-Xlint:all",
        "-Xlint:-preview"
    ])
}

// 同步配置测试任务，避免测试编译时出现警告
tasks.withType(Test).configureEach {
    jvmArgs.add("--enable-preview")
}

2. 正确使用@SuppressWarnings注解 #

@SuppressWarnings("preview")需添加在直接使用预览特性的类或方法上，而非仅在module-info.java中。示例：

@SuppressWarnings("preview")
public class DataLoader {
    // 也可单独添加在使用字符串模板的方法上
    public void loadData() {
        logger.log(SEVERE, STR."Error after \{sheet}/\{rowCounter[0]}, \{t}");
    }
}

3. 处理依赖类的预览警告 #

依赖类使用预览特性时，只要编译参数中包含--enable-preview和-Xlint:-preview，即可覆盖这类警告，上述Gradle配置已包含这两个参数。

验证 #

重新执行gradle compileJava，控制台输出中预览特性相关警告应全部消除。

内容的提问来源于stack exchange，提问作者Hristo Stoyanov