使用自定义_id创建文档时出现_rev为null格式错误求助

看起来你遇到的问题大概率和FxGson的序列化行为有关——虽然你设置了_rev为null，且确认文档不存在、启用了newEntity=true，但自定义的GsonBuilder可能没正确处理null字段，导致它被序列化成字符串"null"而非被忽略，这就触发了CouchDB客户端的格式校验错误。

下面是几个针对性的排查和解决步骤：

1. 调整FxGson的序列化配置 #

FxGson默认不会自动忽略null字段，你需要在构建GsonBuilder时显式添加忽略null的规则：

Gson gson = new FxGsonBuilder()
        .serializeNulls(false) // 关键配置：不序列化null字段
        .create();

当实体类的_rev为null时，这个配置会让Gson直接跳过该字段的序列化，CouchDB客户端就会把它当作全新文档处理，不会触发_rev格式校验。

2. 确认newEntity=true的生效范围 #

部分CouchDB客户端（比如Ektorp）的save方法中，newEntity=true是告知客户端这是新文档、无需校验_rev，但如果实体类被序列化成带有"_rev": "null"的JSON，客户端仍会读取到这个无效值并报错。所以第一步的Gson配置是核心解决点。

3. 验证序列化后的JSON内容 #

可以临时在代码里把待保存的对象序列化输出，确认_rev字段的状态：

String json = gson.toJson(obj);
System.out.println(json);

如果输出里出现"_rev": "null"，那就是序列化的问题，按步骤1修改配置即可；如果_rev字段完全不存在，再去排查save方法是否正确传递了newEntity参数。

4. 检查实体类的字段注解 #

如果你的实体类_rev字段使用了Gson注解，比如@SerializedName，要确保没有强制包含null值的注解：

@SerializedName("_rev")
private String rev; // 避免添加@JsonInclude(Include.ALWAYS)这类强制包含的注解

如果加了强制包含的注解，即使设置了serializeNulls(false)，null字段还是会被序列化出来，导致报错。

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