如何在Cosmos v4 API的container.queryItems()中获取eTag值

这不是Cosmos API的Bug，是你获取ETag的位置和接收结果的方式不对，具体说明如下：

• 你当前读取的是分页查询结果的响应头ETag，这个ETag是整个查询结果页的实体标记，默认查询场景下不会返回该字段，所以为null属于正常行为。你需要的单条文档ETag是文档自身的内置属性，需要从单条文档的属性中读取。
• 正确的获取方式有两种可选：
  1. 用Cosmos SDK自带的CosmosItemProperties类接收查询结果，该类内置了getETag()方法可直接读取单文档的ETag：
     示例代码调整：

  // 构造查询时指定返回类型为CosmosItemProperties
  CosmosPagedFlux<CosmosItemProperties> responseDocuments = container.queryItems(querySpec, new CosmosQueryRequestOptions(), CosmosItemProperties.class);
  responseDocuments.byPage(1)
          .flatMap(page -> {
              page.getResults().forEach(item -> {
                  String eTag = item.getETag(); // 直接获取单文档ETag
                  Person person = item.getObject(Person.class); // 直接转成自定义POJO，无需手动序列化
                  // 后续业务逻辑
              });
              return Flux.empty();
          })
          .blockLast();
  

  2. 自定义POJO中添加ETag映射字段，给字段加@JsonProperty("_etag")注解，SDK会自动映射系统内置的_etag属性：

  public class Person {
      // 你的原有字段
      private String id;
      private String optInStatus;
      // 新增ETag映射字段
      @JsonProperty("_etag")
      private String eTag;
      // 对应getter、setter方法
      public String getETag() {
          return eTag;
      }
      public void setETag(String eTag) {
          this.eTag = eTag;
      }
  }
  

  调整后直接查询返回Person类，即可通过person.getETag()读取到对应文档的ETag。
• 额外注意：你当前代码中先转LinkedHashMap再序列化转POJO的方式会丢失下划线开头的系统内置属性，这也是你之前拿不到ETag的原因之一，建议直接用SDK提供的类型转换方法，避免手动序列化的属性丢失问题。

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