要让 Hibernate 正确映射模块化应用中的实体类（尤其是含 private 字段的类），不能只靠 exports，必须用 opens 显式开放反射权限——因为 Hibernate 在运行时需通过反射读写字段，而 exports 只管 public 成员的“直接调用”，不放行 setAccessible(true)。
要让 Hibernate 正确映射模块化应用中的实体类（尤其是含 private 字段的类），不能只靠 exports，必须用 opens 显式开放反射权限——因为 Hibernate 在运行时需通过反射读写字段，而 exports 只管 public 成员的“直接调用”，不放行 setAccessible(true)。
为什么 exports 不够用
Hibernate 依赖反射注入 private 字段（如 private Long id; 或 private String name;）。即使你已 exports com.example.entity;，JVM 仍会拦截反射访问，抛出 InaccessibleObjectException。这是因为：
-
exports仅允许其他模块“引用并调用”该包内 public 类的 public 成员 - private 字段不属于编译期可见范围，
exports对它完全无效 - 反射穿透需要运行时级授权，由
opens单独控制
opens 的正确写法与作用范围
在 module-info.java 中添加 opens 声明，格式为：
-
opens com.example.entity;→ 允许所有模块对该包内所有类的所有成员（含 private、package-private）执行反射操作 -
opens com.example.entity to org.hibernate.orm.core;→ 更安全：只对 Hibernate 模块开放，其他模块无权反射 - 若使用 Spring Boot 3.x 自动配置，常需同时开放给
org.springframework.data.jpa和org.hibernate.orm.core
常见组合场景与建议
实际项目中，实体、映射配置、Repository 通常分属不同包，需按需开放：
- 实体类在
com.example.domain→ 写opens com.example.domain to org.hibernate.orm.core; - Lombok 生成的
@Data或@Setter字段也受 same 规则约束，只要字段是 private，就必须被opens覆盖 - 若实体含嵌套对象（如
private Address address;），且Address在另一包（如com.example.common），则该包也需opens ... to org.hibernate.orm.core; - 避免写
open module com.example.app;—— 它会开放全部包，破坏封装性，仅作临时调试用
验证是否生效的小技巧
启动应用后观察日志或行为：
- JDK 16+ 下，没配
opens会直接报InaccessibleObjectException，不会静默失败 - 若用
--illegal-access=warn启动，能看到 “WARNING: Illegal reflective access” 提示，说明权限未正确定义 - 用
jdeps --module-path mods/ --list-deps your-module.jar可检查模块间依赖与开放关系 - 真实运行环境测试比 IDE 编译更可靠——IDE 可能绕过部分模块校验
