TimeUnit类在JDK 21中为何无法找到？

Question

**问题描述：** 在使用JDK 21进行Java开发时，开发者尝试通过`import java.util.concurrent.TimeUnit;`引入TimeUnit类，却发现无法找到该类。尽管TimeUnit类长期存在于JDK中，用于简化时间单位转换和线程休眠等操作，但在JDK 21中却报告类不存在。这是为何？实际上，TimeUnit类并未被移除，而是位于正确的`java.util.concurrent`包中。出现该问题的常见原因包括项目配置错误、IDE缓存异常或模块系统（JPMS）未正确识别所需模块。开发者应检查模块声明（module-info.java）是否包含`requires java.base;`，并确保构建工具配置正确，同时清理IDE缓存以排除干扰。

Answer 1

一、问题背景与现象描述

在使用 JDK 21 进行 Java 开发时，开发者尝试通过如下语句引入 TimeUnit 类：

import java.util.concurrent.TimeUnit;

但 IDE（如 IntelliJ IDEA 或 Eclipse）却报错，提示找不到该类。然而，TimeUnit 是 java.util.concurrent 包中的标准类，自 Java 5 起就一直存在，并未在 JDK 21 中被移除。

二、问题定位与排查流程

该问题通常不是由于 JDK 本身的问题，而是与项目配置、模块系统（JPMS）或 IDE 缓存有关。以下是排查流程图：

graph TD
    A[尝试导入TimeUnit类] --> B{是否报错}
    B -->|是| C[检查模块声明]
    C --> D[是否存在module-info.java]
    D --> E{是否包含requires java.base;}
    E -->|否| F[添加requires java.base]
    E -->|是| G[检查构建工具配置]
    G --> H[Maven/Gradle是否配置正确JDK版本]
    H --> I{是否正确}
    I -->|否| J[修正JDK版本配置]
    I -->|是| K[清理IDE缓存]
    K --> L[重启IDE并重新导入]
    B -->|否| M[正常导入]
  

三、常见问题原因分析

以下是导致该问题的常见原因列表：

• 模块系统（JPMS）配置错误： 在使用模块化项目时，若未在 module-info.java 中声明 requires java.base;，则无法访问 java.util.concurrent 中的类。
• IDE 缓存异常： IDE 缓存可能导致旧的索引或编译信息未更新，从而无法识别新版本 JDK 中的类。
• 构建工具配置错误： Maven 或 Gradle 构建文件中指定的 JDK 版本不正确，导致编译时使用了错误的库。
• 项目 SDK 配置错误： IDE 中配置的 SDK 不是 JDK 21，或者 JDK 安装路径有误。
• 多版本 JDK 冲突： 系统中存在多个 JDK 版本，导致运行时使用了旧版本。

四、解决方案详解

以下是针对上述原因的解决方案：

1. 检查 module-info.java 文件

如果你的项目使用了模块系统（JPMS），请确保 module-info.java 文件中包含以下语句：

module your.module.name {
    requires java.base;
}

否则，将无法访问 java.util.concurrent 包下的类。

2. 清理 IDE 缓存并重新导入项目

以 IntelliJ IDEA 为例：

1. 关闭项目。
2. 进入项目目录，删除 .idea 和 .iml 文件。
3. 重新打开项目并重新配置 SDK。

3. 检查构建工具配置

在 pom.xml（Maven）中添加如下配置：

<properties>
    <java.version>21</java.version>
</properties>

在 build.gradle（Gradle）中添加：

tasks.withType(JavaCompile) {
    options.release.set(21)
}

4. 验证当前 JDK 版本

运行以下命令确认当前使用的 JDK 版本：

java -version

确保输出为：

openjdk version "21"...

五、扩展思考：模块系统与兼容性设计

JDK 9 引入的模块系统（JPMS）改变了类路径（classpath）的传统行为。开发者需要明确声明对模块的依赖，这在 JDK 21 中依然适用。因此，理解模块依赖关系对于构建健壮的 Java 应用至关重要。

此外，随着 Java 版本快速迭代，建议开发者定期更新构建工具插件，以确保对新版本的支持。