Quarkus Mutiny+RESTEasy Reactive返回流为何未传输完整对象？

我使用Quarkus + Mutiny + RESTEasy Reactive + ReactivePanacheMongoEntity开发接口，编写了如下响应式REST接口：

@GET
public Multi<Product> streamAllProducts(){
    return Product.streamAll();
}

调用该接口后得到的结果为：

[
    Product<635917 edf0be2d3af200c0b9>,
    Product<635917 f3f0be2d3af200c0ba>,
    Product<635917 f3f0be2d3af200c0bb>
]

而预期得到包含完整字段的对象，格式如下：

[
   {
     "id": "edf0be2d3af200c0b9",
     "name": "Product 1"
   },
   {
     "id": "f3f0be2d3af200c0ba",
     "name": "Product 2"
   },
   {
     "id": "f3f0be2d3af200c0bb",
     "name": "Product 3"
   }
]

使用传统阻塞式RESTEasy时能够返回完整的详细对象，请问：

1. RESTEasy Reactive实际传输的是什么？
2. 该如何正确处理以得到预期的返回结果？

1. RESTEasy Reactive实际传输的内容 #

你看到的Product<...>是实体类的toString()方法输出。传统阻塞式RESTEasy会自动将实体对象序列化为JSON，但RESTEasy Reactive的响应式流处理逻辑不同：当返回Multi<Product>时，若未明确指定序列化方式，框架会直接调用实体的toString()方法，将每个实体转为字符串后拼接成数组返回，而非进行JSON序列化。

2. 正确处理的方法 #

有两种常见解决方案：

方式一：转换为DTO（数据传输对象） #

创建与Product对应的DTO类，包含需要对外暴露的字段，再将流中的实体映射为DTO：

public class ProductDTO {
    public String id;
    public String name;

    public ProductDTO(Product product) {
        this.id = product.id;
        this.name = product.name;
    }
}

修改接口方法：

@GET
public Multi<ProductDTO> streamAllProducts(){
    return Product.streamAll()
                  .map(ProductDTO::new);
}

这种方式符合分层架构设计，避免直接暴露实体类内部细节。

方式二：让实体类支持JSON序列化 #

确保Product实体类添加JSON序列化注解，且Quarkus的Jackson扩展已启用：

1. 添加quarkus-resteasy-reactive-jackson依赖（以Maven为例）：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-resteasy-reactive-jackson</artifactId>
</dependency>

2. 在Product实体类上添加Jackson注解，确保字段可被正确序列化：

import io.quarkus.mongodb.panache.reactive.ReactivePanacheMongoEntity;
import com.fasterxml.jackson.annotation.JsonProperty;

public class Product extends ReactivePanacheMongoEntity {
    @JsonProperty
    public String name;
    // 其他字段...
}

3. 修改接口方法，明确指定返回媒体类型为JSON：

@GET
@Produces(MediaType.APPLICATION_JSON)
public Multi<Product> streamAllProducts(){
    return Product.streamAll();
}

完成后，RESTEasy Reactive会自动将Product实体序列化为JSON对象输出。

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