JBoss 7 EAP中@Startup注解失效：单例Bean无法容器启动时预创建

我之前在JBoss EAP 7上踩过完全一样的坑，折腾了好几个小时才捋清楚问题所在，给你分享几个关键排查点和解决方案：

1. 先确认注解包没导错！ #

这是最容易犯的低级错误——一定要确保@Singleton和@Startup是来自javax.ejb包，而不是Spring或者其他框架的同名注解。很多人会不小心导入Spring的org.springframework.stereotype.Singleton，那JBoss的EJB容器根本不会识别它。

正确的导入应该是：

import javax.ejb.Singleton;
import javax.ejb.Startup;
import javax.ejb.ConcurrencyManagement;
import javax.ejb.ConcurrencyManagementType;

2. 检查JBoss EJB子系统的Startup配置 #

有些情况下，JBoss的配置会被修改，禁用了Startup Bean的自动启动机制。你需要打开standalone.xml或domain.xml，找到ejb3子系统，确认startup-beans的enabled属性是true：

<subsystem xmlns="urn:jboss:domain:ejb3:6.0">
    <!-- 其他配置项 -->
    <startup-beans enabled="true"/>
    <!-- 其他配置项 -->
</subsystem>

如果这个属性是false，所有@Startup标记的Bean都不会在容器启动时初始化。

3. 确保Bean被容器扫描到 #

如果你的Bean所在的包没有被JBoss的Bean扫描机制覆盖，容器根本不知道有这个Bean存在：

• 如果你用的是WAR包，确保Bean放在WEB-INF/classes目录对应的包下，或者在beans.xml里显式声明扫描路径：

  <beans xmlns="http://xmlns.jcp.org/xml/ns/javaee" version="1.1" bean-discovery-mode="all">
      <scan>
          <package>com.yourcompany.yourproject</package>
      </scan>
  </beans>
  

  把com.yourcompany.yourproject换成你的Bean实际所在的包路径，或者直接把bean-discovery-mode设为all，让容器扫描所有类。
• 如果是EAR包，要确保EJB模块的ejb-jar.xml没有禁用扫描，或者同样通过beans.xml配置扫描规则。

4. 排查@PostConstruct的初始化异常 #

如果你的@PostConstruct方法里抛出了未捕获的异常，JBoss容器会静默放弃这个Bean的初始化，不会有明显的报错提示（除非你看日志）。

建议在初始化方法里加上异常捕获和日志输出，或者直接抛出RuntimeException，让容器记录错误：

@PostConstruct
public void initProvisioningData() {
    try {
        // 你的初始化逻辑代码
        System.out.println("ProvisioningDataForAp 已在容器启动时初始化");
        // 或者用日志框架输出，比如SLF4J
        // logger.info("ProvisioningDataForAp initialized on startup");
    } catch (Exception e) {
        // 抛出异常让容器记录错误堆栈
        throw new RuntimeException("初始化ProvisioningDataForAp失败", e);
    }
}

然后去JBoss的server.log里搜索你的Bean类名，看看有没有初始化失败的堆栈信息。

5. 考虑JBoss EAP版本的bug #

早期的JBoss EAP 7.0.x版本存在一些Startup Singleton的已知bug，比如某些情况下Bean不会被触发初始化。如果上面的排查都没问题，可以尝试升级到EAP 7.1.x或者更高的补丁版本，很多这类问题在后续版本里已经被修复了。

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