Java 17迁移XStream遇不可访问对象异常，求--add-opens参数用法

一、--add-opens参数的核心作用 #

Java 9引入模块系统后，JDK内部包默认被封装，外部代码（比如XStream）无法直接访问这些包内的类或成员。XStream在序列化/反序列化时需要调用JDK内部的反射、集合等API，因此必须通过--add-opens参数手动开放指定模块的包给XStream所在的代码，避免触发不可访问对象异常。

二、准确格式与用法 #

--add-opens的完整格式为：

--add-opens <源模块>/<包路径>=<目标模块>

各部分含义：

• 源模块：包含需要开放包的JDK模块（比如核心的java.base模块，大多数XStream需要的内部API都在这里）
• 包路径：需要开放访问的具体包（比如java.util、java.lang.reflect）
• 目标模块：被允许访问该开放包的模块。如果你的项目是传统非模块化项目（没有module-info.java，代码在classpath下），直接用ALL-UNNAMED即可；如果是模块化项目，填写你的项目模块名。

三、XStream场景下的具体参数示例 #

针对XStream的需求，通常需要开放以下几个常用包，你可以直接把这些参数添加到JVM启动参数中：

--add-opens java.base/java.util=ALL-UNNAMED
--add-opens java.base/java.lang.reflect=ALL-UNNAMED
--add-opens java.base/java.text=ALL-UNNAMED
--add-opens java.base/java.io=ALL-UNNAMED
--add-opens java.base/java.math=ALL-UNNAMED

如果使用的XStream版本有特殊需求，可以参考官方文档补充对应的参数，但以上是通用的基础配置。

四、关于“module”的含义 #

这里的module指Java 9及以上引入的模块系统中的模块：

• 每个模块是一组逻辑相关的包、类和资源，拥有明确的访问权限控制，比如java.base是JDK的核心模块，提供所有基础功能；java.xml处理XML相关操作。
• --add-opens中的源模块是你要打破封装的模块，目标模块是被授予访问权限的模块，ALL-UNNAMED是一个特殊的模块名，代表所有未加入模块化系统的代码（即传统classpath下的项目）。

五、单独使用--add-opens失败的原因 #

你之前遇到的“需声明模块”错误，是因为参数格式不完整。--add-opens必须同时指定源模块+包路径和目标模块，不能只写包名。比如错误写法：

# 错误：缺少源模块和目标模块
--add-opens java.util

正确写法必须包含完整的三部分，告诉JVM：开放哪个模块下的哪个包，给哪个模块访问。

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