@Asynchronous是Java EE规范中定义用于EJB异步方法调用的注解，在Payara服务器中得到了完整支持，它允许开发者将耗时的业务逻辑从主线程剥离，避免阻塞请求处理流程，提升应用的响应效率。合理使用该注解可以优化批量处理、消息发送、外部接口调用等场景的执行逻辑。
@Asynchronous注解的基本使用规则
在Payara中使用@Asynchronous注解首先需要满足EJB的基本定义要求，异步方法必须定义在EJB组件类中，包括无状态会话Bean、有状态会话Bean和单例会话Bean都支持异步方法定义。
基础使用示例
定义一个无状态会话Bean，在其中添加异步方法，方法返回值可以是void或者<code>Future</code>类型：
import javax.ejb.AsyncResult;
import javax.ejb.Asynchronous;
import javax.ejb.Stateless;
import java.util.concurrent.Future;
@Stateless
public class AsyncServiceBean {
// 无返回值的异步方法
@Asynchronous
public void processWithoutReturn(String taskName) {
try {
// 模拟耗时操作，比如处理3秒的任务
Thread.sleep(3000);
System.out.println("任务" + taskName + "执行完成");
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
}
}
// 有返回值的异步方法，返回Future类型
@Asynchronous
public Future<String> processWithReturn(String taskName) {
try {
Thread.sleep(3000);
String result = "任务" + taskName + "处理结果为成功";
return new AsyncResult<>(result);
} catch (InterruptedException e) {
Thread.currentThread().interrupt();
return new AsyncResult<>("任务执行被中断");
}
}
}
调用异步方法的注意事项
异步方法的调用和普通EJB方法调用方式一致，但是需要注意调用者和被调用者的关系：
- 同一个EJB内部的方法互相调用时，@Asynchronous注解不会生效，因为EJB的注解增强是基于代理实现的，内部调用不会经过代理层。
- 异步方法的参数和返回值必须支持序列化，因为Payara可能会将异步任务分发到不同的线程甚至不同的节点执行。
- 如果异步方法返回<code>Future</code>类型，调用方可以通过<code>Future.get()</code>方法获取执行结果，该方法会阻塞直到异步任务完成。
Payara中异步调用的特殊配置
Payara对EJB异步调用提供了可配置的管理选项，开发者可以根据应用的负载情况调整异步线程池的参数，避免默认配置不满足业务需求。
异步线程池配置
Payara的EJB异步调用默认使用内置的异步线程池，可以通过管理控制台或者命令行调整线程池的核心线程数、最大线程数、队列长度等参数：
使用asadmin命令行调整异步线程池配置的示例：
# 查看当前异步线程池配置 asadmin get resources.thread-pool.__default-ejb-async-thread-pool.* # 设置核心线程数为10 asadmin set resources.thread-pool.__default-ejb-async-thread-pool.core-threads=10 # 设置最大线程数为50 asadmin set resources.thread-pool.__default-ejb-async-thread-pool.max-threads=50 # 设置任务队列长度为100 asadmin set resources.thread-pool.__default-ejb-async-thread-pool.queue-capacity=100
事务边界处理
@Asynchronous注解的异步方法默认的事务行为和普通EJB方法不同：
- 如果异步方法没有显式指定事务属性，默认使用<code>REQUIRED</code>事务属性，但是事务会在方法执行开始时挂起，异步方法会在新的事务上下文中执行。
- 如果希望异步方法不开启新事务，可以显式添加<code>@TransactionAttribute(TransactionAttributeType.NOT_SUPPORTED)</code>注解。
- 异步方法中的事务提交和回滚不会影响调用方的事务状态，两者的事务是完全独立的。
常见错误用法及修正方案
错误1：同一个Bean内部调用异步方法
很多开发者会在同一个EJB内部调用标注了@Asynchronous的方法，期望实现异步执行，但是实际会发现方法还是同步执行：
@Stateless
public class WrongAsyncBean {
@Asynchronous
public void asyncTask() {
System.out.println("异步任务执行");
}
// 这个方法调用asyncTask不会异步执行
public void callAsyncTask() {
asyncTask();
System.out.println("调用完成");
}
}
修正方案：将异步方法拆分到另一个EJB中，通过注入的方式调用：
@Stateless
public class AsyncTaskBean {
@Asynchronous
public void asyncTask() {
System.out.println("异步任务执行");
}
}
@Stateless
public class CorrectCallBean {
@Inject
private AsyncTaskBean asyncTaskBean;
public void callAsyncTask() {
asyncTaskBean.asyncTask();
System.out.println("调用完成");
}
}
错误2：异步方法抛出受检异常未处理
如果异步方法返回<code>Future</code>类型，并且抛出了未捕获的异常，调用方通过<code>Future.get()</code>获取结果时会抛出<code>ExecutionException</code>，如果返回值是void，异常会被异步线程池吞掉，无法感知。
修正方案：在异步方法内部捕获所有异常，返回值类型的方法可以将异常信息封装到返回结果中，void类型的方法可以记录异常日志或者将异常信息发送到监控系统。
错误3：异步方法中使用非线程安全的实例变量
无状态会话Bean的实例是池化的，多个线程可能同时访问同一个Bean实例，如果异步方法中操作了实例变量，会出现线程安全问题。
修正方案：异步方法中只使用局部变量，或者将需要共享的数据放到线程安全的容器中，避免操作实例变量。
最佳实践总结
在Payara中使用@Asynchronous注解实现EJB异步调用时，建议遵循以下实践：
- 异步方法尽量拆分到独立的EJB中，避免内部调用导致注解失效。
- 根据业务耗时情况合理配置异步线程池参数，避免线程耗尽或者队列溢出。
- 异步方法的返回值优先使用<code>Future</code>类型，方便获取执行结果和异常信息。
- 明确异步方法的事务属性，避免不必要的事务开销或者事务不一致问题。
- 异步方法中不要操作EJB的实例变量，保证线程安全。
EJB@AsynchronousPayara异步方法调用修改时间：2026-06-17 14:33:40