Java微服务在OpenLiberty/Docker中无法访问/orders端点问题

问题现象 #

• 可访问http://localhost:9080，但请求/orders端点返回ERR_EMPTY_RESPONSE
• 已尝试更换端口、开启Windows防火墙端口，问题未解决

核心问题分析与解决方案 #

1. CDI注入失败导致服务无法初始化 #

OrderFacade通过@Inject依赖OrderService，但OrderService仅提供带参数的构造方法public OrderService(String connectionPoolUrl)，CDI容器无法自动实例化该类，导致注入失败。当请求到达时，没有可用的服务实例处理请求，返回空响应。

解决方法：
添加无参构造方法，或通过CDI注入构造参数：

// 方案1：添加无参构造方法并设置默认连接池地址
public OrderService() {
    this.connectionPoolUrl = "http://localhost:9084/connection-pool/get-connection";
}

// 方案2：使用@Inject注入配置参数（需确保配置能被CDI识别）
import org.eclipse.microprofile.config.inject.ConfigProperty;

@Inject
public OrderService(@ConfigProperty(name = "connection.pool.url") String connectionPoolUrl) {
    this.connectionPoolUrl = connectionPoolUrl;
}

2. REST路径冲突引发路由混乱 #

OrderFacade和OrderService都标注了@Path("/orders")，导致OpenLiberty无法正确映射请求路由，端点注册混乱。

解决方法：

• 移除OrderService的@Path注解，将其作为普通业务Bean，仅保留OrderFacade作为对外REST入口
• 或调整OrderService的路径为非重叠值，比如@Path("/order-internal")，避免路径冲突

3. OpenLiberty未启用JAX-RS与CDI核心特性 #

server.xml中缺少JAX-RS和CDI特性配置，OpenLiberty无法自动识别并注册JAX-RS资源。

解决方法：
在server.xml中添加特性管理器配置：

<featureManager>
    <feature>jaxrs-2.1</feature>
    <feature>cdi-2.0</feature>
    <feature>mpRestClient-2.0</feature>
    <!-- 保留原有特性 -->
    <feature>mpMetrics-2.3</feature>
    <feature>mpJwt-1.1</feature>
</featureManager>

4. 日志排查辅助定位 #

查看OpenLiberty容器日志获取具体错误信息：

1. 进入容器：docker exec -it <容器ID> bash
2. 查看日志文件：cat /logs/messages.log
   日志中会明确显示CDI注入失败、资源注册异常等关键信息，帮助精准定位问题。

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