Spring MongoDB调用deleteById(id)无法删除数据的问题排查

一、删除失败的核心原因 #

你的LessonRepository泛型指定的ID类型是UUID，但实体类Lesson的id字段定义为String类型，二者类型不匹配导致查询不到目标数据：

• 调用deleteById(UUID id)时，Spring Data MongoDB会把传入的UUID对象转换成**BSON二进制格式（BinData）**去MongoDB中匹配_id
• 但你库中的_id是字符串格式的UUID（如"11c4ee15-0048-4cc6-8a62-38e40389f2a8"），二进制格式与字符串格式无法匹配，因此找不到对应文档，删除操作失败。

二、可行的解决方法 #

方案1：统一ID类型为String #

修改Repository的泛型，将ID类型改为String，与实体类保持一致：

public interface LessonRepository extends MongoRepository<Lesson, String> {
}

同时调整删除方法的参数类型：

public void deleteLesson(String id) {
    lessonRepository.deleteById(id);
}

调用时直接传入字符串格式的UUID即可，能和库中的_id完全匹配。

方案2：统一ID类型为UUID（并调整存储格式） #

如果想使用UUID类型作为ID，需要调整实体类字段类型，并配置Spring Data MongoDB将UUID以字符串格式存储（避免二进制）：

1. 修改实体类：

@Data
public class Lesson {
    @Id
    private UUID id;
    private String title;
    private String content;
}

2. 添加MongoDB配置类，指定UUID的存储策略为字符串：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.data.mongodb.core.convert.MongoCustomConversions;
import java.util.Arrays;
import org.springframework.data.mongodb.core.convert.UuidConverter;

@Configuration
public class MongoConfig {
    @Bean
    public MongoCustomConversions mongoCustomConversions() {
        return new MongoCustomConversions(Arrays.asList(UuidConverter.STRING));
    }
}

配置后，MongoDB会将UUID以字符串格式存储，与你现有库中的_id格式一致，后续调用deleteById(UUID id)即可正常匹配删除。

三、关于UUID存储与ObjectId的疑问 #

• 为什么UUID会生成二进制对象？：MongoDB默认对UUID类型的处理是存储为BSON的BinData类型（二进制数据），这是MongoDB对UUID的原生存储方式，而非字符串格式。
• 为什么不是ObjectId格式？：ObjectId是MongoDB内置的默认主键类型，由时间戳、机器标识、进程ID和计数器组成的12字节二进制值，和UUID（16字节，基于随机/时间算法生成）是完全不同的两种主键类型，二者没有关联，因此UUID不会自动转换为ObjectId。

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