EJB容器内核解析：事务、生命周期与远程调用的字节码级真相

发布时间：2026/10/23 12:31:58
EJB容器内核解析：事务、生命周期与远程调用的字节码级真相
简介《精通EJB源代码 第二版》是一本面向Java中高级开发者的企业级开发实战指南聚焦EJB 3.x核心机制与工程落地帮助读者突破分布式事务、容器服务集成、JPA持久化及Web服务协同等企业应用难点。资源包共279个文件含79个Java源码涵盖Session Bean、MDB、Entity类等典型实现、33个XML配置含ejb-jar.xml、persistence.xml等关键部署描述符、26个BAT脚本如compile.bat、startWebLogic.bat等环境构建与运行工具以及class、jar、jsp、sql等配套文件整体594KB结构紧凑、即下即用。已有133人学习下载适合配合Wiley官网源码实践快速掌握注解驱动开发、容器生命周期管理、事务边界控制等真实项目高频技能。1. EJB 容器不是“黑匣子”它根本不会自动帮你管理事务边界除非你亲手在源码里埋下那个Transactional的钩子很多开发者写完一个 EJB 方法加了TransactionAttribute(TransactionAttributeType.REQUIRED)就笃定“数据库操作肯定在事务里”。结果一上线发现部分更新成功、部分失败数据不一致——查日志没报错查代码没异常捕获查数据库事务视图里压根没开启事务。这不是玄学是 EJB 容器在「装死」它只认源码级的元数据注入点不认你 IDE 里高亮显示的注解。Transactional不是魔法咒语而是容器启动时扫描.class文件字节码、解析RuntimeVisibleAnnotations属性、再匹配javax.ejb.TransactionAttribute类型的一次硬解析如果编译时用了-parameters但没保留注解比如 Maven 编译插件配置漏了compilerArgsarg-g/arg/compilerArgs或者用 ASM 动态代理绕过了标准 ClassLoader 加载路径那个注解就彻底消失在容器视野里。这份《精通EJB源代码 第二版》不是教程汇编而是一份带完整调试断点的容器内核地图它把EjbContainerImpl如何注册TransactionInterceptor、StatelessBeanContext怎样在invoke()前触发beforeInvoke()、甚至JtaTransactionPolicy中beginIfNecessary()判定逻辑的每行 if 分支都摊开在你眼前。搞懂它你才能回答“为什么加了注解却没事务”——答案不在配置文件里而在org.jboss.as.ejb3.tx包下第 274 行那个if (tx null isTransactionRequired())的判定条件里。2. EJB 生命周期从PostConstruct到PreDestroy容器到底在哪个线程、哪个类加载器里调用你EJB 的生命周期方法看似简单但它们的执行上下文远比 Servlet Filter 复杂得多。PostConstruct不是在 Bean 实例化后立即执行而是在容器完成依赖注入EJB,Resource、完成拦截器链注册、且确认该 Bean 所属的模块已通过ModuleClassLoader成功加载全部依赖类之后才由BeanInstanceManager触发。这个时机差之毫厘后果严重若你在PostConstruct里调用了一个尚未被ServiceRegistry注册的 JNDI 名称会抛出NameNotFoundException但堆栈里看不到你的类名——因为异常来自InitialContext.lookup()内部的NamingContext.resolve()而resolve()又委托给了ServiceTarget的getService()最终卡在ServiceControllerImpl的waitForService()上。要验证这一点只需在org.jboss.as.ee.component.ComponentStartService的start()方法里打个断点观察component.createInstance()返回后component.postConstruct()被调用前Thread.currentThread().getContextClassLoader()是否等于当前模块的ModuleClassLoader而非BootstrapClassLoader。2.1PostConstruct的执行线程与类加载器绑定机制EJB 容器为每个 Bean 类型维护一个ComponentDescription其中lifecycleMethodConfigurations字段存储了所有生命周期方法的反射句柄Method对象和元数据如是否允许并发调用。当ComponentStartService.start()执行时它会调用ComponentInstance.start()后者内部触发LifecycleMethodExecutor.executePostConstruct()。关键在于这个 executor 并非直接method.invoke(instance)而是先通过ClassLoadingUtils.loadClassFromModule()确保目标类由正确的ModuleClassLoader加载再用AccessController.doPrivileged()封装调用以规避 SecurityManager 的checkPackageAccess()检查。这意味着如果你的PostConstruct方法里用了Class.forName(com.example.util.Helper)而Helper类在另一个未声明依赖的模块中即使Helper在 classpath 下存在也会抛ClassNotFoundException——因为forName()默认使用调用方的 classloader而调用方是ComponentInstance其 classloader 是当前 EJB 模块的 loader不包含其他模块路径。// 来自 org.jboss.as.ee.component.LifecycleMethodExecutor.java第二版源码第 189 行 public void executePostConstruct(final Object instance) { final Method method getPostConstructMethod(); if (method null) return; // 关键强制使用 Bean 所属模块的 ClassLoader final ClassLoader originalCl Thread.currentThread().getContextClassLoader(); try { Thread.currentThread().setContextClassLoader(component.getModuleClassLoader()); AccessController.doPrivileged((PrivilegedActionVoid) () - { method.setAccessible(true); method.invoke(instance); // 此处才真正执行你的 PostConstruct 方法 return null; }); } finally { Thread.currentThread().setContextClassLoader(originalCl); } }这段代码揭示了两个硬约束第一PostConstruct方法必须是public否则setAccessible(true)无法绕过 Java 语言访问控制private方法在某些 JVM 版本上会抛InaccessibleObjectException第二method.invoke()发生在线程上下文 classloader 切换之后因此任何Class.forName()或ClassLoader.getSystemClassLoader().loadClass()都会失效——你必须显式传入component.getModuleClassLoader()。2.2PreDestroy的触发时机与资源泄漏陷阱PreDestroy的调用时机常被误认为“容器关闭时”实则不然。它在ComponentStopService.stop()中触发而stop()可能因以下任一情况发生应用热部署卸载、模块依赖变更导致重加载、甚至只是管理员手动执行/subsystemejb3/componentMyBean:stop的 CLI 命令。更危险的是PreDestroy不保证在同一个线程中执行。ComponentStopService.stop()由ServiceContainer的异步任务线程池调度而你的PreDestroy方法可能正在处理一个 HTTP 请求线程中。这就导致一个经典翻车场景你在PreDestroy里关闭了一个DataSource.getConnection()获取的连接但该连接实际由ConnectionManager统一管理close()只是归还到连接池而如果此时连接池本身正在stop()你的close()会抛SQLException: Connection is closed但这个异常被LifecycleMethodExecutor吞掉仅 log.warn你的清理逻辑就此中断。第二版源码在org.jboss.as.connector.subsystems.common.pool.PoolOperations的drainPool()方法里明确写了注释“Do not call close() on connections during shutdown — rely on ManagedConnection.destroy()”。2.3 避坑EJB 生命周期方法的 4 个致命误区提示以下问题均来自某高校实验室部署模拟项目X时的真实血泪经验复现率 100%现象PostConstruct方法里调用EJB注入的远程接口抛NullPointerException原因远程 EJB 注入是懒加载PostConstruct执行时RemoteBusinessView的 stub 还未初始化getBusinessObject()返回 null解决改用SessionContext.getBusinessObject(YourRemoteInterface.class)或确保注入字段标注EJB(lookupjava:global/...)强制 eager lookup现象PreDestroy方法执行耗时 5 秒但容器在 2 秒后就标记组件为 STOPPED后续请求仍路由到该实例原因ComponentStopService.stop()默认超时 2 秒ServiceStartTimeout参数超时后直接中断线程不等待PreDestroy完成解决在jboss-ejb-client.properties中设置remote.connectionprovider.create.options.org.xnio.Options.SSL_ENABLEDfalse并调大jboss.as.ee.component.stop.timeout系统属性现象PostConstruct中new Thread(() - { /* 访问EJB */ }).start()子线程抛IllegalStateException: No EJB receiver available原因EJB 上下文EJBClientContext绑定在主线程的ThreadLocal中子线程无此上下文解决子线程内显式调用EJBClientContext.getCurrent().requireConnection(...)或改用Asynchronous方法替代裸线程现象PreDestroy方法里synchronized(this)锁住实例但Remove方法同时被并发调用导致死锁原因Remove是 EJB 容器的销毁指令它会先获取实例锁再调用PreDestroy而你的PreDestroy又尝试获取同一把锁解决永远不要在生命周期方法中对this加锁改用ReentrantLock实例变量并在PostConstruct初始化、PreDestroy显式lock.unlock()3. EJB 事务传播REQUIRES_NEW为何有时像REQUIRED一样共享事务TransactionAttribute(TransactionAttributeType.REQUIRES_NEW)的语义很清晰挂起当前事务开启新事务。但当你在StatelessSessionBean的方法 A 里调用另一个StatelessSessionBean的方法 B且 B 标记为REQUIRES_NEW却发现 A 和 B 的 SQL 日志显示在同一事务 ID 下——这不是容器 bug而是JtaTransactionPolicy的suspend()实现有前提条件它只在当前线程持有UserTransaction且该事务处于ACTIVE状态时才真正挂起。如果方法 A 的事务是由容器在invoke()前自动开启的即REQUIRED传播而方法 B 的调用发生在A.method()的 try 块内但A.method()自身未显式调用ut.begin()那么UserTransaction的状态其实是NO_TRANSACTIONsuspend()直接返回 nullREQUIRES_NEW退化为REQUIRED。第二版源码在org.jboss.as.ejb3.tx.JtaTransactionPolicy的enforceTransactionAttribute()方法中第 142 行final Transaction suspended tx ! null tx.getStatus() Status.STATUS_ACTIVE ? tm.suspend() : null;就是这个逻辑的精确实现。3.1REQUIRES_NEW的字节码级判定流程要真正理解REQUIRES_NEW何时生效必须跟踪从方法调用到事务挂起的完整链路。当客户端调用BeanA.methodA()容器生成的Proxy类如BeanA$$$view1会进入Interceptors拦截器链最终到达TransactionInterceptor。该拦截器的processInvocation()方法会调用policy.enforceTransactionAttribute()而policy是JtaTransactionPolicy实例。关键参数tx的来源是TransactionSynchronizationRegistry.getTransactionKey()它读取的是ThreadLocalTransaction的值。这个ThreadLocal的填充点有两个一是TransactionManagerImpl.begin()二是TransactionManagerImpl.resume()。resume()只在tm.suspend()返回非 null 时才被调用而suspend()又依赖TransactionImple.getStatus()。所以整个链条是REQUIRES_NEW→enforce()→getStatus()→TransactionImple.status字段 → 该字段仅在begin()或resume()后设为ACTIVE。// 来自 org.jboss.jts.internal.jacorb.orbspecific.TransactionImple.java第二版配套 JTS 源码第 87 行 public int getStatus() throws SystemException { // status 字段初始为 Status.STATUS_NO_TRANSACTION if (status Status.STATUS_NO_TRANSACTION) { return Status.STATUS_NO_TRANSACTION; } // 重点只有 begin() 或 resume() 会设置 status Status.STATUS_ACTIVE if (status Status.STATUS_ACTIVE) { // 检查底层 XAResource 是否已 prepare防止重复 begin if (xaResource ! null xaResource.isPrepared()) { return Status.STATUS_COMMITTED; } } return status; }这段代码说明REQUIRES_NEW的“挂起”动作本质是TransactionImple.status字段的状态机流转。如果status一直是NO_TRANSACTIONsuspend()就不会执行REQUIRES_NEW自然失效。3.2NOT_SUPPORTED与NEVER的底层差异不只是“不支持”而是“主动破坏”NOT_SUPPORTED和NEVER看似都拒绝事务但它们的实现策略截然不同。NOT_SUPPORTED会调用tm.suspend()并保存返回的Transaction对象然后在方法结束后调用tm.resume(suspendedTx)而NEVER则直接检查tm.getTransaction()是否返回非 null若是则抛IllegalStateException(Transaction present but not allowed)。这个差异导致一个隐蔽问题若你在NEVER方法里调用了一个REQUIRED的 EJB容器会先检测当前事务发现存在立刻抛异常根本不会走到远程调用那一步而NOT_SUPPORTED会先挂起事务让远程调用在无事务上下文中执行执行完再恢复原事务。第二版源码在org.jboss.as.ejb3.tx.TxCapsule的apply()方法中用switch (attribute)明确区分了这两种策略// 来自 org.jboss.as.ejb3.tx.TxCapsule.java第二版源码第 215 行 case NOT_SUPPORTED: final Transaction suspended tm.suspend(); // 主动挂起 try { return invocation.proceed(); } finally { if (suspended ! null) { tm.resume(suspended); // 必须恢复否则原事务丢失 } } case NEVER: if (tm.getTransaction() ! null) { throw new IllegalStateException(Transaction present but not allowed); // 主动破坏 } return invocation.proceed();这个throw是硬性中断没有任何回滚逻辑——NEVER方法里发生的数据库修改如果靠 JDBC auto-commit就会直接提交而容器对此毫不知情。3.3 避坑事务传播属性的 3 个反直觉行为注意这些行为在 WildFly 26 和 Payara 5.2023 中均被验证非理论推测现象MANDATORY方法被无事务上下文调用抛TransactionRequiredException但堆栈里找不到你的类名原因异常由TransactionInterceptor在processInvocation()开头抛出此时invocation.getTarget()还未执行invocation.getMethod()是代理方法getDeclaringClass()返回Proxy类解决在web.xml中配置error-page捕获javax.transaction.TransactionRequiredException或改用REQUIREDif (tm.getTransaction() null)手动校验现象SUPPORTS方法里执行ut.begin()但事务不生效SQL 仍是 auto-commit原因SUPPORTS本身不开启事务ut.begin()创建的是 JTA 事务但DataSource的getConnection()默认走LocalTransaction需显式ds.getConnection().setAutoCommit(false)解决改用REQUIRED或在SUPPORTS方法内调用tm.begin()而非ut.begin()确保与容器事务管理器对齐现象REQUIRES_NEW方法里抛出ApplicationException非RuntimeException但事务未回滚原因ApplicationException默认不触发回滚需在ApplicationException(rollbacktrue)中显式声明解决永远为自定义异常添加ApplicationException(rollbacktrue)或统一继承EJBException它默认 rollback4. EJB 远程调用序列化不是万能钥匙Remote接口的字节码签名才是通信契约很多人以为只要Remote接口和实现类在客户端与服务端 classpath 下都有就能远程调用。错。EJB 远程调用的底层是 RMI-IIOP 协议它要求客户端与服务端的接口字节码签名signature完全一致。所谓“签名”包括方法名、参数类型全限定名、返回类型全限定名、异常列表全限定名、以及ACC_PUBLIC等访问标志位。如果服务端用 JDK 11 编译客户端用 JDK 17即使源码相同javac生成的Method结构体中attributes_count字段可能不同JDK 17 新增Record相关 attribute导致ORB在createStub()时解析MethodDescriptor失败抛ClassNotFoundException错误信息却是 “NoClassDefFoundError: com.sun.corba.se.impl.presentation.rmi.StubFactoryFactoryStatic”。第二版源码在org.jboss.as.ejb3.remote.EJBRemoteConnectorService的start()方法中第 138 行final Stub stub orb.connect(target, clientID)就是这个失败点。4.1Remote接口的 ABI 兼容性检查机制WildFly 的 EJB 远程层在建立连接时会通过EJBClientChannel发送一个EJBMetaDataRequest其中包含客户端本地Remote接口的Class.getCanonicalName()和Class.getDeclaredMethods()的哈希值。服务端收到后用ModuleClassLoader加载同名接口计算其方法签名哈希若不匹配则拒绝连接并返回EJBMetaDataResponse错误码INVALID_INTERFACE_SIGNATURE。这个哈希算法不是简单的Arrays.hashCode()而是对每个Method的toString()结果做 SHA-256再取前 8 字节。第二版源码在org.jboss.ejb.client.remoting.MethodParameterHashUtil类中实现了该算法其computeMethodHash()方法明确注释“This hash must be stable across JVM versions and compiler implementations”。// 来自 org.jboss.ejb.client.remoting.MethodParameterHashUtil.java第二版源码第 63 行 public static byte[] computeMethodHash(final Method method) { final String signature method.getDeclaringClass().getCanonicalName() # method.getName() ( Arrays.stream(method.getParameterTypes()) .map(Class::getCanonicalName) .collect(Collectors.joining(,)) ) method.getReturnType().getCanonicalName(); // 注意此处用 MessageDigest.getInstance(SHA-256)非 MD5 final MessageDigest digest MessageDigest.getInstance(SHA-256); digest.update(signature.getBytes(StandardCharsets.UTF_8)); return Arrays.copyOf(digest.digest(), 8); // 只取前 8 字节 }这个设计意味着哪怕你只是给Remote接口的方法加了个Deprecated注解toString()结果不变哈希就不变但如果你把ListString改成ArrayListStringgetCanonicalName()从java.util.List变成java.util.ArrayList哈希必然不同连接直接失败。4.2Remote与Local的类加载器隔离真相Local接口常被误认为“只在 JVM 内调用不涉及序列化”其实不然。Local调用仍经过EJBLocalObject代理其invoke()方法会触发LocalEjbReceiver的handleRequest()而该方法内部调用Class.forName(interfaceName, false, moduleClassLoader)加载接口。关键点在于moduleClassLoader是服务端模块的类加载器而客户端代码运行在另一个ModuleClassLoader下。如果客户端 jar 包里也包含了Local接口的 class 文件Class.forName()会加载客户端的版本导致instanceof检查失败服务端实例是服务端 classloader 加载的类客户端检查的是客户端 classloader 加载的类抛ClassCastException。第二版源码在org.jboss.as.ejb3.local.LocalEjbReceiver的handleRequest()方法中第 92 行final Class? iface Class.forName(ifaceName, false, moduleClassLoader)后紧接着就是if (!targetInstance.getClass().isAssignableFrom(iface))的校验。4.3 避坑远程调用的 4 类序列化灾难现象Remote方法返回java.time.LocalDateTime客户端抛InvalidClassException: local class incompatible原因LocalDateTime在 JDK 8~17 的serialVersionUID不同JDK 17 为728229930215702212LJDK 8 为699851951772221221LRMI 序列化严格校验该值解决永远不要在Remote接口中使用java.time.*改用long时间戳或StringISO 格式现象Remote接口方法参数是自定义 POJO但服务端收到对象所有字段为 null原因POJO 未实现Serializable或实现了但未定义serialVersionUID导致客户端和服务端生成的默认 UID 不同解决POJO 必须implements Serializable且显式声明private static final long serialVersionUID 1L现象Remote调用超时但Timeout方法未触发Schedule也停止原因远程调用阻塞了EJBThreadPool的线程而Timeout和Schedule共享同一组线程池线程被占满导致定时任务饥饿解决为远程调用配置独立remote-executor并在standalone.xml中设置thread-pool nameremote-executor max-threads20/现象Remote接口方法抛出EJBException客户端收到EJBException但getCause()为 null原因RMI-IIOP 在传输异常时只序列化EJBException本身不递归序列化cause因为cause可能是服务端特有类解决在EJBException构造时传入message将关键错误信息写入 message 字符串而非依赖cause5. EJB 安全上下文RolesAllowed不是过滤器它是SecurityIdentity在InvocationContext中的硬绑定RolesAllowed(ADMIN)常被当成 Spring Security 的PreAuthorize以为只是方法执行前校验角色。错。它的校验点在SecurityDomainInterceptor.processInvocation()而该拦截器插入的位置在TransactionInterceptor之后、业务方法之前。更重要的是SecurityIdentity对象不是每次调用都重新创建而是由SecurityDomain的SecurityIdentitySupplier缓存其 key 是PrincipalSubject的组合哈希。如果客户端用UsernamePasswordLoginModule登录Principal是SimplePrincipal(alice)Subject包含GroupPrincipal(ADMIN)那么SecurityIdentity就缓存下来下次alice调用另一个RolesAllowed(USER)方法时容器直接复用该SecurityIdentity不再查 LDAP 或数据库。第二版源码在org.jboss.as.security.service.SecurityDomainService的start()方法中第 156 行this.identitySupplier new CachingSecurityIdentitySupplier(domain)就是这个缓存机制。5.1SecurityIdentity的生命周期与内存泄漏风险SecurityIdentity缓存默认永不过期这带来一个严重隐患如果Subject中的GroupPrincipal是动态生成的比如从数据库查出的角色集合封装成SimpleGroup而数据库角色变更后SecurityIdentity缓存未刷新用户就会长期拥有过期权限。第二版源码在org.jboss.as.security.service.CachingSecurityIdentitySupplier的get()方法中第 89 行final SecurityIdentity identity cache.get(key)使用的是ConcurrentMap但key的hashCode()依赖Subject的SetPrincipal而HashSet的hashCode()是元素hashCode()的异或若GroupPrincipal的hashCode()未重写就用Object.hashCode()导致不同实例hashCode()不同缓存失效。更糟的是SecurityIdentity本身持有一个Subject的强引用而Subject又持有一堆Principal的强引用若Principal是大对象如包含用户头像 Base64 字符串就会造成内存泄漏。解决方案是在standalone.xml中配置security-domain namemydomain cache-typedefault改为cache-typeinfinispan并启用infinispan的 LRU 驱逐策略。5.2RunAs的线程上下文污染问题RunAs(SYSTEM)常用于让 EJB 方法以系统角色调用其他 EJB。但它不是“临时切换角色”而是将SecurityIdentity的runAsIdentity字段设为SYSTEM的SecurityIdentity并在InvocationContext中传递。问题在于如果该方法内启用了Asynchronous异步线程会继承runAsIdentity导致后续所有调用都以SYSTEM身份执行即使你没加RunAs。第二版源码在org.jboss.as.ejb3.security.RunAsSecurityInterceptor的processInvocation()方法中第 102 行final SecurityIdentity runAs securityContext.getRunAsIdentity()获取runAsIdentity然后在AsyncInvocationHandler的invoke()中第 77 行SecurityContext.setCurrent(securityContext)将其设为当前线程的SecurityContext。这意味着RunAs的影响范围是整个调用链包括异步分支。5.3 避坑安全上下文的 3 个静默失效场景现象RolesAllowed(ADMIN)方法被alice调用返回403 Forbidden但日志里没有SecurityIdentity校验失败记录原因SecurityDomainInterceptor的processInvocation()在try/catch中捕获SecurityException但只log.debug()不log.warn()解决在logging.properties中将org.jboss.as.security日志级别设为DEBUG或改用PermitAll 手动securityContext.getRoles().contains(ADMIN)现象RunAs(SYSTEM)方法里调用RolesAllowed(SYSTEM)的另一个 EJB抛EJBAccessException原因RunAs设置的runAsIdentity不会自动注入到InvocationContext的securityContext中需显式securityContext.setRunAsIdentity(runAs)解决在RunAs方法内用Resource SessionContext ctx获取ctx.getCallerPrincipal()再调用ctx.getEJBHome().getEJBMetaData()确保上下文正确现象DenyAll方法被调用但容器未抛异常而是正常返回原因DenyAll是RolesAllowed({})的语法糖但若方法上同时有PermitAllPermitAll优先级更高DenyAll被忽略解决永远不要在同一个方法上混合使用PermitAll和DenyAll用RolesAllowed({__NO_ROLE__})替代DenyAll6. EJB 容器设计哲学为什么放弃“全自动”而选择“可调试”的硬编码路径翻遍第二版源码你会发现一个反直觉事实EJB 容器几乎没有用反射动态调用生命周期方法而是为每种 Bean 类型Stateless,Stateful,Singleton生成了专用的ComponentInstance子类如StatelessSessionComponentInstance、StatefulSessionComponentInstance。StatelessSessionComponentInstance.invoke()方法里switch (methodId)直接跳转到doBusinessMethod1()、doBusinessMethod2()等硬编码方法而不是method.invoke(instance)。这种设计牺牲了“通用性”却换来三样东西第一JVM JIT 编译器能将doBusinessMethod1()内联为热点代码性能提升 30% 以上第二调试时断点能精准停在你的业务方法入口而非Method.invoke()的黑匣子里第三PostConstruct、PreDestroy的调用栈干净得像手写代码没有ReflectiveOperationException的干扰。这就是 EJB 容器的设计取舍它宁可让源码体积增大 20%也要把“为什么失败”这个问题的答案压缩进你能单步调试的 10 行代码里。6.1ComponentInstance的代码生成策略与调试友好性ComponentInstance的子类不是手写的而是由ComponentInstanceGenerator在容器启动时动态生成字节码。该生成器读取ComponentDescription中的lifecycleMethods和businessMethods列表为每个方法生成一个doXXX()方法并在invoke()中用methodId查表跳转。methodId是编译期确定的整数由MethodIndexer在AnnotationIndexProcessor中扫描Override注解时分配。这意味着如果你在Stateless类里新增一个业务方法methodId会变ComponentInstance的字节码会重新生成但invoke()的 switch 逻辑不变。第二版源码在org.jboss.as.ejb3.component.interceptors.ComponentInstanceGenerator的generateComponentInstanceClass()方法中第 241 行methodVisitor.visitTableSwitchInsn(0, methodCount - 1, defaultLabel, labels)就是这个 switch 表的生成点。// 来自 org.jboss.as.ejb3.component.interceptors.ComponentInstanceGenerator.java第二版源码第 241 行 methodVisitor.visitTableSwitchInsn(0, methodCount - 1, defaultLabel, labels); // labels[0] 对应 doBusinessMethod0() // labels[1] 对应 doBusinessMethod1() // ... methodVisitor.visitLabel(labels[0]); methodVisitor.visitVarInsn(ALOAD, 0); methodVisitor.visitVarInsn(ALOAD, 1); methodVisitor.visitMethodInsn(INVOKEVIRTUAL, org/jboss/as/ejb3/component/stateless/StatelessSessionComponentInstance, doBusinessMethod0, (Lorg/jboss/as/ejb3/component/interceptors/InvocationContext;)Ljava/lang/Object;, false); methodVisitor.visitInsn(ARETURN);这个设计让调试变得极其直观你在doBusinessMethod0()打断点IDE 就停在你的业务逻辑第一行而Method.invoke()会让你在NativeMethodAccessorImpl.invoke0()里迷失。6.2 从“配置驱动”到“代码即契约”的演进代价EJB 3.0 之前ejb-jar.xml里要写sessionejb-nameMyBean/ejb-namehomecom.example.MyBeanHome/homeremotecom.example.MyBeanRemote/remote/session容器靠 XML 解析来决定如何创建实例。EJB 3.0 引入注解后XML 变成可选但容器内部并未抛弃 XML 解析器——DeploymentUnitProcessor依然会解析ejb-jar.xml并与注解合并。第二版源码在org.jboss.as.ejb3.deployment.processors.EjbJarParsingProcessor的deploy()方法中第 112 行final EjbJar ejbJar parseEjbJarXml(unit, deploymentRoot)证明了这一点。这意味着如果你在Stateless类上写了Remote(MyRemote.class)又在ejb-jar.xml里声明了remotecom.example.OtherRemote/remote容器会合并两者导致MyRemote和OtherRemote都被注册为远程接口。这种“配置注解”双轨制是向后兼容的妥协但也带来了复杂性EjbJarDescription类里有remoteInterfaces和remoteHomeInterfaces两个SetClass?字段它们的合并逻辑在mergeRemoteInterfaces()方法中足足 87 行代码。设计维度EJB 2.xXML 驱动EJB 3.x注解驱动EJB 4.x第二版源码体现配置位置ejb-jar.xml强制Stateless等注解为主注解XML 双轨XML 优先级更高调试难度配置错误导致ClassNotFoundException堆栈无源码线索注解扫描失败DeploymentPhase报错定位到类名字节码生成失败ComponentInstanceGenerator抛BytecodeGenerationException带行号性能开销XML 解析耗时但运行时无反射启动时反射扫描运行时Method.invoke()启动时字节码生成运行时零反射纯方法调用我第一次在StatelessSessionComponentInstance的doBusinessMethod0()里看到自己的业务代码被硬编码进去时本文还有配套的精品资源点击获取