WildFly 11远程EJB客户端无法接收预期异常的问题排查

你遇到的这个问题是WildFly远程EJB通信的常见坑——远程调用中，异常不能随便抛，必须满足几个条件才能被客户端正确接收，否则就会被包装成EJBException或者出现序列化相关的错误（比如你看到的InvalidObjectException）。

问题根源 #

WildFly的远程EJB协议要求：

• 要传递到客户端的异常必须是可序列化的（实现Serializable接口）
• 必须在远程接口中明确声明抛出该异常（不能只泛泛地抛Exception）
• 客户端的类路径中必须存在完全相同的异常类（包名、类名、序列化ID都要一致）

你的示例里直接抛Exception，虽然Exception本身是可序列化的，但接口只声明了throws Exception，加上协议处理的限制，导致服务器端无法正确传递原始异常，最终客户端收到包装后的错误。

分步解决方法 #

1. 创建符合要求的自定义异常

首先，你的自定义异常（比如NotLoggedInException）必须实现Serializable，并且建议显式声明序列化ID，避免版本不一致问题：

package de.fhac.ks.ss18;

import java.io.Serializable;

public class NotLoggedInException extends Exception implements Serializable {
    // 显式指定序列化ID，确保客户端和服务端版本兼容
    private static final long serialVersionUID = 1L;

    public NotLoggedInException() {
        super();
    }

    public NotLoggedInException(String message) {
        super(message);
    }
}

2. 修改远程接口，明确声明异常

不要在接口中只写throws Exception，要把具体的自定义异常写进去，这样WildFly才知道要把这个异常传递到客户端：

package de.fhac.ks.ss18;

import javax.ejb.Remote;

@Remote
public interface ExceptionToClientBeanRemote {
    // 替换泛泛的Exception为具体的自定义异常
    void foo() throws NotLoggedInException;
}

3. 修改EJB实现类，抛出自定义异常

在无状态Bean中直接抛出你定义的异常即可：

package de.fhac.ks.ss18;

import javax.ejb.Stateless;

@Stateless
public class ExceptionToClientBean implements ExceptionToClientBeanRemote {
    @Override
    public void foo() throws NotLoggedInException {
        System.out.println("foo");
        // 抛出自定义异常
        throw new NotLoggedInException("用户未登录，请先登录");
    }
}

4. 确保客户端能访问异常类

如果是Maven项目，客户端模块需要依赖包含该异常的模块（比如把异常放到一个公共JAR包，让服务端和客户端都依赖它）；如果是简单项目，直接把异常类的.class文件放到客户端的类路径里。

5. 修改客户端代码，捕获具体异常

现在客户端可以直接捕获到自定义异常了，不用再处理包装后的EJBException：

try {
    exceptionToClientBean.foo();
} catch (NotLoggedInException e) {
    System.err.println("收到自定义异常：" + e.getMessage());
    e.printStackTrace();
} catch (Exception e) {
    // 处理其他意外情况
    e.printStackTrace();
}

额外注意事项 #

• 不要在远程EJB中抛出RuntimeException，这类异常会被WildFly自动包装成EJBException传递到客户端，无法直接捕获原始异常
• 自定义异常必须是检查型异常（继承自Exception），而不是运行时异常，这样才能在接口中声明抛出
• 始终保持客户端和服务端的异常类版本一致，尤其是serialVersionUID，否则会出现序列化失败的问题

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