使用Spring Data向Couchbase存储POJO时User字段持久化为null的问题

看起来你遇到的核心问题是实体类的注解配置不符合预期，导致Spring Data Couchbase不知道该如何处理ProjectXYZ里的User字段。我帮你拆解两种常见场景的解决方案：

场景1：将User作为嵌套JSON嵌入到ProjectXYZ文档中 #

如果你的需求是让User成为ProjectXYZ文档的一部分（而非独立的Couchbase文档），问题出在User类上的@Document注解：

• @Document是用来标记顶级Couchbase文档的，嵌套对象完全不需要这个注解，直接移除它即可。
• 修改后的User类代码：

  @JsonInclude(value = Include.NON_EMPTY)
  // 移除@Document注解
  public class User {
      @Field
      private String id;
      @Field
      private String email;
      @Field
      private String firstName;
      @Field
      private String lastName;
      // setter and getter
  }
  

• 保留ProjectXYZ中user字段的@Field注解，这样Spring Data Couchbase就会自动将User对象序列化为嵌套JSON，和ProjectXYZ的其他字段一起存储。

场景2：将User作为独立文档，ProjectXYZ存储User的ID引用 #

如果User需要作为单独的Couchbase文档存在，ProjectXYZ仅存储它的ID引用，需要做两个关键调整：

1. 在ProjectXYZ的user字段上，把@Field替换为@Reference注解：

   @JsonInclude(value = Include.NON_EMPTY)
   @Document
   public class ProjectXYZ {
       @Id
       @GeneratedValue(strategy = GenerationStrategy.UNIQUE)
       private String id;
       @Field
       private String prjname;
       @Reference // 替换@Field为@Reference
       private User user;
       // setter and getter
   }
   

2. 必须先保存User对象，再保存ProjectXYZ：Spring Data Couchbase需要依赖User的持久化ID来存储引用，如果User还未被保存到Couchbase，就会出现存储为null的情况。修改你的保存逻辑：

   // 先持久化User，确保它获得Couchbase分配的ID
   User user = getUser(request);
   user = userService.save(user); // 假设你有对应的User服务层
   
   ProjectXYZ project = new ProjectXYZ();
   project.setUser(user);
   project = projectXYZService.createProject(project);
   

   这种场景下，User类的@Document注解要保留，因为它是独立的顶级文档实体。

额外排查小技巧 #

先确认getUser(request)返回的User对象不是null，也不是所有字段都为空（虽然你配置了NON_EMPTY，但只要对象本身非空就应该被序列化）。可以在保存前加一行调试代码验证：

User user = getUser(request);
System.out.println("待保存的User对象：" + user); // 临时调试用，上线后换成日志框架打印

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