Spring Data Reactive Couchbase仓库无法删除数据问题求助

我之前在开发Reactive Couchbase应用时也碰到过一模一样的问题——能正常创建、查询，但删除操作完全没效果，结合踩过的坑，给你几个核心排查和解决方向：

1. 先确认实体类的注解是否正确映射 #

Reactive Couchbase对实体的注解要求很严格，如果你的User类没有正确标注，删除操作会找不到对应的文档：

• 必须给实体类加上@Document注解，标识这是Couchbase文档
• 主键字段必须加上@Id注解，确保Spring Data能识别文档的唯一标识

正确的实体类示例：

@Document
public class User {
    @Id
    private String id;
    private String name;
    // 省略getter、setter和构造方法
}

2. 检查Reactive流是否被正确订阅 #

这是Reactive编程最容易踩的坑：所有Reactive操作都是懒加载的，不订阅就不会实际执行。如果你的Service层只是调用了删除方法但没处理返回的Mono，那删除操作根本不会触发。

错误写法（不会执行删除）： #

@Service
class UserServiceImpl implements UserService {
    @Autowired
    private UserRepository userRepository;

    public void deleteUser(String id) {
        // 只调用方法但没订阅，操作不会执行
        userRepository.deleteById(id);
    }
}

正确写法二选一： #

• 推荐：返回Mono交给上层（比如Controller）订阅：

@Service
class UserServiceImpl implements UserService {
    @Autowired
    private UserRepository userRepository;

    public Mono<Void> deleteUser(String id) {
        // 返回Mono，由调用者（如Controller）订阅触发执行
        return userRepository.deleteById(id);
    }
}

• 测试场景：手动阻塞订阅（生产不推荐）：

@Service
class UserServiceImpl implements UserService {
    @Autowired
    private UserRepository userRepository;

    public void deleteUser(String id) {
        // 用block()阻塞等待操作完成，仅测试用
        userRepository.deleteById(id).block();
    }
}

3. 验证Couchbase的索引与权限 #

虽然你能正常查询，但还是要确认：

• 检查Couchbase控制台中，user设计文档下的主索引（由@N1qlPrimaryIndexed生成）是否存在且状态正常
• 确认连接Couchbase的用户拥有文档删除权限，避免因权限不足导致操作静默失败

4. 调试排查操作状态 #

可以给删除操作添加日志监听，确认操作是否真的执行或抛出异常：

userRepository.deleteById("targetUserId")
    .doOnSuccess(v -> System.out.println("✅ 删除操作执行成功"))
    .doOnError(e -> System.err.println("❌ 删除失败：" + e.getMessage()))
    .subscribe();

这样能直观看到操作的结果，避免误以为操作无效，实际上是有异常被吞了。

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