在 Quarkus 响应式编程中，需先通过 map() 提取响应体为 String，再用 await().indefinitely() 阻塞获取最终字符串值，适用于缓存等同步场景。
在 quarkus 响应式编程中，需先通过 `map()` 提取响应体为 `string`，再用 `await().indefinitely()` 阻塞获取最终字符串值，适用于缓存等同步场景。
在 Quarkus 应用中，当调用 REST 客户端方法（如 clientService.someMethod(id)）时，返回的是 Uni<response></response> —— 一个响应式、非阻塞的异步容器。若下游服务（如缓存组件 cacheService）要求传入同步的 String 类型，就必须完成两个关键步骤：从 Response 中读取并序列化响应体为字符串，以及从 Uni 中安全提取该字符串值。
直接使用 ObjectMapper 或 Gson 序列化 Response 对象本身是无效的，因为 Response 是 JAX-RS 的抽象接口，其内容需通过 readEntity() 显式读取。正确做法是利用 Uni.map() 转换内部值：
Uni<String> stringUni = response.map(r -> r.readEntity(String.class));
此处 r.readEntity(String.class) 会触发响应体的实际读取（支持 UTF-8 自动解码），并返回原始响应字符串（如 JSON、XML 或纯文本）。注意：该操作必须在 Uni 的链式上下文中执行，不可在外部对未订阅的 Uni 直接调用 readEntity()。
接下来，为获得阻塞式的 String（满足 cacheService(id, mapObj, responseObjectAsAString) 的签名），需使用 Uni.await() 进行等待：
String responseBody = response
.map(r -> r.readEntity(String.class))
.await()
.indefinitely(); // 无限期等待，直到结果可用（生产环境建议设超时）⚠️ 重要注意事项：
-
await().indefinitely()会阻塞当前线程，仅推荐在明确需要同步语义的边界场景使用（如集成遗留缓存 SDK、单元测试或 CLI 入口）。在纯响应式业务逻辑中，应优先保持Uni<string></string>并继续链式处理（例如onItem().transformToUni(...)）。 - 生产代码中务必避免无限等待，推荐改用带超时的
await().atMost(Duration.ofSeconds(5))，并配合异常处理：String responseBody; try { responseBody = response .map(r -> r.readEntity(String.class)) .await() .atMost(Duration.ofSeconds(3)); } catch (TimeoutException e) { throw new RuntimeException("Failed to read response within timeout", e); } - 若响应可能为空或失败，可结合
onFailure().recoverWithItem()或asOptional()提升健壮性：Optional<String> optionalBody = response .map(r -> r.readEntity(String.class)) .await() .asOptional() .atMost(Duration.ofSeconds(3));
综上，转换的核心在于理解 Uni 的响应式本质：不“强制转换”，而是通过声明式操作（map）和受控等待（await）桥接异步与同步世界。
