跨项目实体类加载异常排查与JSF实体转换器解决方案咨询

首先，你的推测方向正确，但还有一个更直接的低级错误需要优先修正：

1. 紧急修正：类名字符串格式错误 #

从错误日志能看到，传入Class.forName()的类名是class de.example.com.user.model.MyEntity——这明显带了多余的class 前缀，直接导致JVM找不到对应类。

这个问题出在EntityConverter的getAsString方法里：

// 错误写法：Class.toString()会返回"class 全限定类名"格式的字符串
return value.getClass() + ":" + ((AbstractEntity) value).getSid();

你需要改成获取类的纯全限定名：

// 正确写法：返回无多余前缀的类名
return value.getClass().getName() + ":" + ((AbstractEntity) value).getSid();

这一步是基础，不修正的话，哪怕解决了类加载器问题，依然会报类找不到的错误。

2. 类加载器问题的根源与解决 #

你的核心推测是对的：在JBoss/WildFly这类Java EE容器中，EAR内的EJB、WAR模块拥有独立的类加载器，默认情况下WAR模块的类加载器无法直接访问EJB模块的类。结合你用Maven Overlay合并WAR的场景，project2-web.war的类加载器看不到project1-ejb.jar中的MyEntity类，导致加载失败。

下面是几种可行的解决方案：

方案A：通过JBoss部署配置声明依赖 #

在project2-web.war的WEB-INF目录下创建jboss-deployment-structure.xml，显式让它依赖project1-ejb模块：

<jboss-deployment-structure>
    <deployment>
        <dependencies>
            <!-- 允许project2-web访问project1-ejb的类 -->
            <module name="deployment.project-ear.ear.project1-ejb.jar" export="true"/>
        </dependencies>
    </deployment>
</jboss-deployment-structure>

这个配置会告诉JBoss类加载器，打破模块间的类隔离限制。

方案B：通过Maven依赖声明显式关联 #

在project2-web的pom.xml中添加对project1-ejb的依赖，设置scope为provided（因为EJB已经包含在EAR中，不需要打包进WAR）：

<dependency>
    <groupId>你的项目groupId</groupId>
    <artifactId>project1-ejb</artifactId>
    <version>对应版本号</version>
    <scope>provided</scope>
</dependency>

Maven会在构建时处理这个依赖关系，帮助容器识别模块间的类访问权限。

方案C：使用线程上下文类加载器加载类 #

修改ShsEntityLoader的loadEntity方法，用线程上下文类加载器（通常是发起请求的Web模块的类加载器）来加载类：

@Override
public AbstractEntity loadEntity(String className, Long sid) {
    AbstractEntity entity = null;
    try {
        // 用线程上下文类加载器适配跨模块类访问场景
        Class<?> entityClass = Thread.currentThread().getContextClassLoader().loadClass(className);
        entity = (AbstractEntity) entityManager.find(entityClass, sid);
    } catch (ClassNotFoundException ex) {
        log.warn("Could not load entity for class: " + className, ex);
    }
    return entity;
}

这个方案不需要额外配置，但最好配合方案A或B使用，确保上下文类加载器能访问到EJB模块的类。

方案D：将共享类移到EAR/lib #

如果项目结构允许，可以把MyEntity类和ShsEntityLoader移到EAR的lib目录下的JAR中（比如ekbframework.jar或单独的共享JAR）。EAR/lib中的JAR是所有模块共享的，WAR和EJB都能直接访问其中的类，从根源上解决类加载隔离问题。

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