求助：ReactiveRepository.save()在Couchbase中无法生效（继承ReactiveCrudRepository）

我来帮你排查下Couchbase中repo.save(person)失效的问题——既然repo.findAll()能正常工作，说明基础连接和配置是没问题的，大概率是实体类、Repository配置、事务或权限相关的细节问题，咱们一步步来梳理：

这是最容易踩坑的点，一定要确认以下几点：

• 实体类是否添加了@Document注解，并指定了正确的Bucket名称：

  @Document(bucket = "your-target-bucket")
  public class Person {
      // ...
  }
  

• 主键字段是否标记了@Id，如果需要自动生成ID，还要搭配@GeneratedValue指定Couchbase的生成策略：

  @Id
  @GeneratedValue(strategy = GenerationType.UNIQUE)
  private String id;
  

• 普通字段是否添加了@Field注解（如果字段名和Couchbase文档中的键名一致，也可以省略，但显式标注更稳妥）。

PersonRepository必须正确继承Spring Data Couchbase的Repository接口，比如：

public interface PersonRepository extends CouchbaseRepository<Person, String> {
    // 自定义查询方法（如果有的话）
}

如果继承的是普通JpaRepository或者其他非Couchbase的Repository，save操作自然不会生效。

Spring Data Couchbase的save操作默认需要事务支持，如果你是在Service层调用save，一定要确保方法上添加了@Transactional注解：

@Service
public class PersonService {
    private final PersonRepository repo;

    public PersonService(PersonRepository repo) {
        this.repo = repo;
    }

    @Transactional
    public Person savePerson(Person person) {
        return repo.save(person);
    }
}

没有事务的话，save操作可能不会真正提交到Couchbase。

虽然你手动能添加文档，但程序使用的连接账号可能没有写入权限：

1. 打开Docker中Couchbase的Web控制台（默认端口8091）
2. 进入Security > Users页面，找到程序配置的连接账号
3. 确认该账号对目标Bucket拥有bucket_write或bucket_full_access权限

开启Spring Data Couchbase的DEBUG日志，能帮你看到save操作时的底层报错：
在application.properties中添加：

logging.level.org.springframework.data.couchbase=DEBUG
logging.level.com.couchbase.client=DEBUG

运行程序后查看控制台输出，大概率能找到权限不足、ID冲突、序列化失败等具体问题的线索。

如果你没贴POM的具体版本，要确保Spring Boot（如果使用）、Spring Data Couchbase、Couchbase Java SDK的版本相互匹配：

• Spring Boot 3.x → Spring Data Couchbase 4.x + Couchbase SDK 3.x
• Spring Boot 2.x → Spring Data Couchbase 3.x + Couchbase SDK 2.x
  版本不兼容会导致各种诡异的操作失效问题。

可以写个简单的测试类，直接注入Repository调用save，排除Service层逻辑的干扰：

@SpringBootTest
public class CouchbaseSaveTest {
    @Autowired
    private PersonRepository repo;

    @Test
    void testDirectSave() {
        Person testPerson = new Person();
        testPerson.setName("Test User");
        Person savedPerson = repo.save(testPerson);
        System.out.println("Saved person ID: " + savedPerson.getId());
        // 之后可以去Couchbase控制台查看是否存在该文档
    }
}

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