在 Quarkus 响应式编程中，需先通过 map() 提取 HTTP 响应体为字符串（r.readEntity(String.class)），再用 await().indefinitely() 阻塞获取最终值；注意避免在响应式链中滥用阻塞操作，生产环境推荐异步传递 Uni。

在 quarkus 响应式编程中，需先通过 `map()` 提取 http 响应体为字符串（`r.readentity(string.class)`），再用 `await().indefinitely()` 阻塞获取最终值；注意避免在响应式链中滥用阻塞操作，生产环境推荐异步传递 `uni`。

在 Quarkus 应用中，当你通过 REST Client 调用远程服务时，返回类型通常是 Uni<response></response>（来自 SmallRye Mutiny），它代表一个异步、惰性、单次发射的响应式流。直接对 Uni<response></response> 调用 ObjectMapper 或 Gson.toJson() 会失败，因为 Uni 本身不是实体对象——它只是一个计算容器，尚未执行，也未包含实际响应体内容。

要将其转为 String，本质需分两步完成：

1. 从 Uni<response></response> 映射为 Uni<string></string>：利用 Response.readEntity(Class<t>)</t> 方法读取响应体（如 JSON 字符串），并确保在 map() 中安全调用（该方法会自动消费响应流）；
2. 从 Uni<string></string> 获取阻塞式 String 值：使用 await().indefinitely()（或带超时的 atMost(Duration)）同步等待结果。

✅ 正确示例代码如下：

Quark Lazy Cli

基于夸克网盘自动转存项目 QAS 的懒人追剧、追番 SKILL，内置 CLI 工具。即使 QAS 订阅失效，仍可重新搜索资源、遍历多级目录，在多个最新候选中按用户偏好（如更高清晰度）转存新集和缺失集。可交由本地 OpenClaw、Hermes Agent 或其他 Claude 客户端使用。

下载

Uni<Response> response = clientService.someMethod(id);

// 步骤1：转换为 Uni<String>（非阻塞、声明式）
Uni<String> stringUni = response
    .map(r -> {
        if (r.getStatus() >= 400) {
            throw new RuntimeException("HTTP error: " + r.getStatus());
        }
        return r.readEntity(String.class); // ✅ 真正读取响应体
    })
    .onFailure().recoverWithItem("ERROR_RESPONSE"); // 可选：兜底处理

// 步骤2：阻塞获取 String（仅限非响应式上下文，如 @Blocking 方法或测试）
String responseObjectAsAString = stringUni
    .await()
    .atMost(Duration.ofSeconds(10)); // 推荐设超时，避免永久挂起

// 传入缓存服务
cacheService(id, mapObj, responseObjectAsAString);

⚠️ 重要注意事项：

• 避免在响应式链中阻塞：若当前方法已标记为 @GET 或属于非阻塞端点（如默认的 @Path 方法），请不要调用 await() —— 这会破坏响应式流，导致线程阻塞和吞吐量下降。此时应改为：

  response
      .map(r -> r.readEntity(String.class))
      .subscribe().with(
          body -> cacheService(id, mapObj, body),
          err -> log.error("Cache write failed", err)
      );

• readEntity(String.class) 会自动关闭响应流并解码响应体，无需手动调用 close()；
• 若响应体较大或需结构化处理，建议直接 readEntity(MyDto.class) 后再序列化，而非先转 String 再反序列化；
• await().indefinitely() 仅适用于测试、命令行工具或明确标注 @Blocking 的方法中。

总结：Uni<response></response> → String 的核心是“先映射再等待”，但务必根据执行上下文选择同步阻塞还是纯响应式订阅，以兼顾正确性与性能。