<think>我们正在解决用户在使用Zulu
JDK17时遇到的类找不到
问题：`sun
.awt.SunHints`。根据引用[4]和用户提供的信息，这个
问题通常是由于在
JDK9及以上版本中，内部API（如`sun`包下的类）被封装，默认不可访问。###原因分析在
JDK9引入模块化系统（Jigsaw）后，`sun`包下的内部API不再被默认导出。因此，尝试访问`sun
.awt.SunHints`会抛出`ClassNotFoundException`或`IllegalAccessError`[^4]。###解决方案以下是两种解决方法：####✅方法1：
运行时添加JVM参数（推荐）在
运行程序时，添加以下参数来开放`sun
.awt`包：```bash
java--add-exports=
java.desktop/sun
.awt=ALL-UNNAMED-jaryour-application
.jar```####✅方法2：Maven编译配置若使用Maven，在`pom
.xml`中配置编译器插件：```xml<build><plugins><plugin><groupId>org
.apache
.maven
.plugins</groupId><artifactId>maven-compiler-plugin</artifactId><version>3
.11
.0</version><!--使用最新版本--><configuration><source>
17</source><target>
17</target><compilerArgs><!--开放sun
.awt包--><arg>--add-exports</arg><arg>
java.desktop/sun
.awt=ALL-UNNAMED</arg></compilerArgs></configuration></plugin></plugins></build>```###替代方案：避免使用内部API长期建议是**避免使用`sun`包下的类**，因为它们不稳定且不可移植。例如：-替代`sun
.awt.SunHints`：使用标准的`
java.awt.RenderingHints`类[^4]。```
java//代替newSunHints(
...)RenderingHintshints=newRenderingHints(RenderingHints
.KEY_ANTIALIASING,RenderingHints
.VALUE_ANTIALIAS_ON);```###验证重新编译并
运行程序，确认
问题解决：```bashmvncleaninstall
java--add-exports=
java.desktop/sun
.awt=ALL-UNNAMED-jartarget/your-app
.jar```###根本原因-
JDK9+的模块系统将`sun
.*`包设为**非导出**（non-exported）[^3][^4]。-数学描述：模块系统的访问控制可表示为：$$\text{access}(\text{module}A,\text{package}P)=\begin{cases}\text{允许}&\text{若}P\in\text{exports}(A)\\\text{拒绝}&\text{否则}\end{cases}$$其中`sun
.awt`未包含在`
java.desktop`模块的导出包中。---通过上述任一方法开放内部API访问权限即可解决
问题，但迁移到标准API是最佳实践[^4]。§§相关
问题§§1
.如何在Gradle中配置`--add-exports`参数？2
.JDK模块化系统（Jigsaw）的主要设计目标是什么？3
.除了`--add-exports`，还有哪些参数可以解决模块访问
问题？4
.如何检查一个类是否属于
JDK内部API？5
.Zulu
JDK与Oracle
JDK在内部API访问上有区别吗？</think>### 解决 Zulu
JDK 17 找不到 `sun
.awt.SunHints` 类的
问题
####
问题原因分析
`sun
.awt.SunHints` 是
JDK 内部 API，在
JDK 9+ 中：
1
. **模块化系统限制**：
JDK 9 引入的模块系统（Jigsaw）将 `sun
.*` 包设为**非导出模块**，默认不可访问[^3][^4]
2
. **Zulu
JDK 17 强化封装**：Zulu
JDK 17 严格遵循
Java 模块规范，完全禁止访问内部 API[^1][^3]
3
. **兼容性变化**：`SunHints` 在
JDK 8 中可访问，但
JDK 9+ 需要显式授权[^4]
---
### 解决方案
#### ✅ 方法 1：
运行时添加 JVM 参数（推荐）
在启动命令中添加模块开放参数：
```bash
java --add-exports=
java.desktop/sun
.awt=ALL-UNNAMED -jar your-app
.jar
```
- `--add-exports`：开放指定模块的包
- `
java.desktop/sun
.awt`：目标模块和包路径
- `ALL-UNNAMED`：允许所有未命名模块访问
#### ✅ 方法 2：Maven 编译配置
在 `pom
.xml` 中添加编译器参数：
```xml
<build>
<plugins>
<plugin>
<groupId>org
.apache
.maven
.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3
.11
.0</version>
<configuration>
<source>
17</source>
<target>
17</target>
<compilerArgs>
<!-- 开放 sun
.awt 包 -->
<arg>--add-exports</arg>
<arg>
java.desktop/sun
.awt=ALL-UNNAMED</arg>
</compilerArgs>
</configuration>
</plugin>
</plugins>
</build>
```
#### ✅ 方法 3：使用替代 API（最佳实践）
**避免使用 `sun
.*` 内部 API**，改用标准 API：
```
java
// 替代方案：使用标准 RenderingHints
import
java.awt.RenderingHints;
RenderingHints hints = new RenderingHints(
RenderingHints
.KEY_ANTIALIASING,
RenderingHints
.VALUE_ANTIALIAS_ON
);
```
#### ✅ 方法 4：模块描述符配置
在 `module-info
.java` 中声明依赖：
```
java
module your
.module {
requires
java.desktop;
opens your
.package to
java.desktop; // 显式开放包
}
```
---
### 根本原因与兼容性
|
JDK 版本 | `sun
.*` 访问权限 | 解决方案 |
|-------------|----------------------|-------------------------|
|
JDK 8 | ✅ 默认开放 | 无需特殊配置 |
|
JDK 9-16 | ⚠️ 受限访问 | `--add-exports` |
| **
JDK 17+** | ❌ 严格禁止 | 必须显式授权或改用标准 API |
数学描述：模块系统的访问控制可表示为：
$$
\text{access}( \text{module } A, \text{package } P ) =
\begin{cases}
\text{允许} & \text{若 } P \in \text{exports}(A) \\
\text{拒绝} & \text{否则}
\end{cases}
$$
其中 `sun
.awt` 未包含在 `
java.desktop` 模块的导出包中[^3][^4]。
---
### 验证步骤
1
. 添加解决方案配置
2
. 重新编译项目：
```bash
mvn clean package
```
3
. 使用开放参数
运行：
```bash
java --add-exports=
java.desktop/sun
.awt=ALL-UNNAMED -jar target/app
.jar
```
> **重要提示**：长期建议迁移到标准 API，内部 API 可能在未来的
JDK 版本中彻底移除[^3][^4]。
扫一扫
878
到【灌水乐园】发言
