生成失败异常 (generation_exception) 错误排查与解决

# 错误响应通常包含详细的生成错误信息
{
  "error": {
    "type": "generation_exception",
    "reason": "Failed to generate [...]",
    "caused_by": {
      "type": "...",
      "reason": "..."
    }
  }
}

// 确保传入的对象可以正确序列化
// 检查对象结构
System.out.println(objectToSerialize.toString());

// 检查是否有循环引用

// 使用 @JsonIgnore 或类似注解忽略循环引用字段
@JsonIgnore
private ParentClass parent;

// 或使用自定义序列化器

# 使用 API 验证映射语法
PUT /<index>/_mapping
{
  "properties": {
    "field": {
      "type": "text"
    }
  }
}

// 如果对象序列化失败，可以使用原始 JSON 字符串
String mappingJson = "{ \"properties\": { \"field\": { \"type\": \"text\" } } }";
putMappingRequest.source(mappingJson, XContentType.JSON);

// 确保字段类型正确映射
// 参考 Easysearch 类型映射
Map<String, Object> fieldMapping = new HashMap<>();
fieldMapping.put("type", "text");
fieldMapping.put("analyzer", "standard");

// 如果内容过大，分批处理
for (Batch batch : batches) {
    processBatch(batch);
}

<!-- Maven -->
<dependency>
    <groupId>org.easysearch</groupId>
    <artifactId>easysearch-rest-high-level-client</artifactId>
    <version>7.x.x</version> <!-- 与服务端版本一致 -->
</dependency>

# 增加客户端 JVM 堆内存
java -Xms2g -Xmx2g -jar application.jar

# 或在环境变量中设置
export JAVA_OPTS="-Xms2g -Xmx2g"

// 确保特殊字符正确处理
// 使用 UTF-8 编码
String jsonString = objectMapper.writeValueAsString(object);
byte[] bytes = jsonString.getBytes(StandardCharsets.UTF_8);

// 避免过于复杂的嵌套结构
// 使用简单的 Map 或 POJO
Map<String, Object> mapping = new HashMap<>();
mapping.put("type", "text");

# 使用 JSON 验证工具
echo '{"test": "value"}' | jq '.'

# 或使用在线验证器

// 处理可能为 null 的字段
@JsonInclude(JsonInclude.Include.NON_NULL)
public class MyObject {
    private String field;
    // getter/setter
}

// 尝试使用不同的序列化器
// 或手动构建 JSON
XContentBuilder builder = XContentFactory.jsonBuilder();
builder.startObject();
{
    builder.field("field", "value");
}
builder.endObject();

# 启用详细日志查看完整的错误信息
# 在客户端配置中启用调试日志
<logger name="org.easysearch" level="DEBUG"/>