处理JPMS模块及Java 8与Java 9+（含17）兼容性的正确方法

问题根因 #

你遇到的是Java 9引入的JPMS（Java平台模块系统）的访问限制规则：java.desktop模块下的com.sun.java.swing.plaf等内部包属于JDK非公开API，默认不允许外部模块访问，所以高版本运行会报错。

之前方案失效原因 #

• 命令行加--add-exports参数可以临时绕过限制，但需要每次启动都携带，确实不适合分发场景。
• 类路径（-cp）加载时Manifest的Add-Exports配置不生效，是因为该配置仅在jar包作为模块化组件通过模块路径（-p）加载时才会被识别，类路径下的所有jar都会被归入未命名模块，相关Manifest配置会被直接忽略。

长期最优方案，按需求二选一即可 #

方案1：固化启动参数（优先推荐，改造成本最低，兼容Java 8到17全版本）

不需要对现有应用代码做任何改造，也不需要做模块化改造，只需要把--add-exports参数固化到启动逻辑中即可：

• 如果是自研分发的应用，把参数写到启动脚本中，增加Java版本判断逻辑：Java 8运行时不携带该参数，Java 9及以上版本自动携带。--add-exports参数在Java 9到17全版本通用，不需要区分版本配置。
• 如果是用打包工具（如jpackage、Install4j、SpringBoot Maven插件等）做标准化分发，可以直接把启动参数内置到打包配置中，用户启动时无感知，不需要额外操作。
  该方案是存量Java 8应用兼容高版本的最常用方案，完全满足长期维护要求。

方案2：改造为模块化Jar（适合有模块化需求的场景）

如果你后续需要用到JPMS的模块隔离、jlink裁剪运行时等特性，可以选择全量模块化改造：

1. 在应用源码目录下新增module-info.java声明模块信息，直接在文件中配置需要的导出权限，示例：

module com.your.app {
    // 依赖jdk的desktop模块
    requires java.desktop;
    // 声明需要访问的内部plaf包权限
    opens com.sun.java.swing.plaf.windows to com.your.app;
    opens com.sun.java.swing.plaf.mac to com.your.app;
}

2. 如果需要同时兼容Java 8，可以采用多版本Jar（Multi-Release JAR）打包方式，将module-info.class放到META-INF/versions/9/目录下，Java 8运行时会自动忽略该文件，Java 9及以上版本会正常识别模块配置。
   改造完成后通过模块路径（-p）加载应用，不需要额外携带--add-exports参数即可正常运行。

选型建议 #

如果只是需要解决plaf等内部包的访问问题，没有其他模块化需求，直接选择方案1即可，改造成本几乎为零，也不会影响现有业务逻辑。只有当你需要用到JPMS的专属特性时，再考虑方案2的模块化改造。

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