基于Jakarta与TomEE Plume的REST API启动异常排查求助

问题分析 #

从报错栈来看，核心异常是java.lang.IllegalStateException: On a thread without an initialized context nor a classloader mapping a deployed app，触发点在于TomEE的TomEEMicroProfileListener注册SmallRye Opentracing组件时，CDI上下文未正确绑定到当前线程。虽然API调用正常，但这个异常是纯JAX-RS应用（无CDI Bean）与TomEE默认启用的MicroProfile特性冲突导致的。

解决方案 #

1. 启用CDI上下文 #

TomEE Plume默认启用CDI，若项目中无任何带CDI注解的Bean，会导致上下文初始化不完整。添加一个空的CDI激活类：

import jakarta.enterprise.context.ApplicationScoped;

@ApplicationScoped
public class CdiActivator {
}

或者在WEB-INF/beans.xml中明确配置CDI扫描模式：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="https://jakarta.ee/xml/ns/jakartaee"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="https://jakarta.ee/xml/ns/jakartaee https://jakarta.ee/xml/ns/jakartaee/beans_4_0.xsd"
       version="4.0"
       bean-discovery-mode="annotated">
</beans>

2. 显式注册JAX-RS应用 #

创建JAX-RS应用类，手动指定资源类，避免TomEE自动扫描触发MicroProfile监听器：

import jakarta.ws.rs.ApplicationPath;
import jakarta.ws.rs.core.Application;
import java.util.Set;
import java.util.HashSet;

@ApplicationPath("/api")
public class RestApplication extends Application {
    @Override
    public Set<Class<?>> getClasses() {
        Set<Class<?>> resources = new HashSet<>();
        resources.add(HelloResources.class);
        return resources;
    }
}

3. 禁用不必要的MicroProfile特性 #

如果不需要OpenTracing功能，可在依赖中排除相关组件。若使用Maven，修改TomEE依赖：

<dependency>
    <groupId>org.apache.tomee</groupId>
    <artifactId>tomee-plume</artifactId>
    <version>你的TomEE版本</version>
    <scope>provided</scope>
    <exclusions>
        <exclusion>
            <groupId>io.smallrye</groupId>
            <artifactId>smallrye-opentracing</artifactId>
        </exclusion>
    </exclusions>
</dependency>

4. 升级TomEE版本 #

部分旧版本TomEE存在此上下文绑定问题，升级到最新稳定版（如TomEE 9.1.0+或10.x）可修复已知bug。

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