软件开发的小伙伴们！在咱们日常开发里，尤其是在互联网大厂的项目中，经常会碰到要把不同技术整合起来的情况。今天就来唠唠让不少人头疼的事儿 —— 在 Spring Boot3 项目里整合 MongoDB 数据库。你是不是也在面对这个任务时，感觉步骤多得让人眼花缭乱，完全不知道该从哪儿开始？别着急，这篇文章就给你安排得明明白白！

为啥要把 Spring Boot3 和 MongoDB 凑一块儿？

在如今这个快节奏的开发环境里，效率就是王道。Spring Boot3 作为当下超流行的 Java 开发框架，它的优势那可太多了。自动配置功能简直是开发神器，能帮咱省掉大量繁琐的配置工作，快速搭建起稳定的项目框架。而且它对各种主流技术的集成支持都特别友好，这就为我们整合其他强大的工具提供了便利。

MongoDB 呢，是一款在开源领域相当火爆的 NoSQL 数据库。它有啥特别之处呢？和传统的关系型数据库不同，MongoDB 采用 BSON（Binary JSON）这种二进制格式存储数据，这种方式让它能灵活地表示各种复杂的结构化数据。举个例子，要是你在开发一个社交平台项目，涉及到用户发布的动态，里面可能包含文字、图片、视频，还有各种复杂的点赞、评论关系，用 MongoDB 来存储这些数据就再合适不过了，因为它能轻松应对这种半结构化的数据场景。

MongoDB 还有个厉害的地方，就是动态模式。啥意思呢？就是说它不需要我们提前定义好数据模式，在数据结构不断变化的项目中，这种特性就显得特别强大。想象一下，你的项目要不断迭代新功能，数据结构也跟着频繁调整，如果用传统数据库，每次修改都得小心翼翼地调整表结构，而 MongoDB 就能让你毫无负担地适应这些变化。

再说说它的查询操作，MongoDB 支持类似 SQL 的查询语言，这对咱们开发者来说太友好了，上手容易。而且它还具备分片能力，能把数据分布到多台服务器上，大大提升了系统的性能和可扩展性。要是你的项目用户量增长迅猛，数据量呈爆发式增长，MongoDB 的这个特性就能保证你的系统依然稳定高效地运行。

所以啊，把 Spring Boot3 和 MongoDB 整合起来，就像是给你的开发工作装上了一对强力翅膀，能让你的项目在性能、灵活性和开发效率上都有质的飞跃。

整合步骤

引入 pom 依赖

这是整合的第一步，也是很关键的基础。在你的 Spring Boot3 项目的 pom.xml 文件里，你需要添加以下依赖：

<dependencies> <!-- Spring Boot Web依赖，用于构建Web应用 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency> <!-- Spring Boot核心依赖 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter</artifactId> </dependency> <!-- Spring Data MongoDB依赖，用于与MongoDB交互 --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-data-mongodb</artifactId> </dependency> <!-- Lombok依赖，简化Java代码编写 --> <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency></dependencies>

这里面，spring-boot-starter-web 是用来构建 Web 应用的，要是你的项目涉及到前后端交互，这个依赖必不可少。spring-boot-starter 是 Spring Boot 的核心依赖，它提供了很多基础的功能支持。spring-boot-starter-data-mongodb 则是专门用来和 MongoDB 进行交互的，有了它，Spring Boot 才能识别和操作 MongoDB 数据库。Lombok 这个依赖也很实用，它能帮我们简化 Java 代码的编写，像自动生成 getter、setter 方法，还有构造函数等，能让我们的代码看起来更简洁优雅。

配置文件设置

引入依赖后，接下来要在配置文件里告诉 Spring Boot 怎么连接到 MongoDB 数据库。一般来说，Spring Boot 的配置文件是 application.properties 或者 application.yml，这里以 application.yml 为例：

spring: data: mongodb: uri: mongodb://testadmin:123456@127.0.0.1:27017/test

在这个配置里，uri 字段指定了数据库的连接地址。mongodb:// 后面跟着的是用户名和密码，这里是 testadmin 和 123456，然后是数据库服务器的地址 127.0.0.1 和端口号 27017，最后的 test 是要连接的数据库名称。你得根据自己实际的数据库配置信息来修改这里的内容哦。

创建用户实体类

有了数据库连接，我们得定义数据在 Java 里的表现形式，也就是创建实体类。假设我们要创建一个用户实体类，代码大概是这样：

import lombok.Data;import org.springframework.data.annotation.Id;import org.springframework.data.mongodb.core.mapping.Document;@Document(collection = "users")@Datapublic User { @Id private String id; private String username; private String email; // 其他用户相关字段，比如密码、年龄等}

这里用了 Lombok 的 @Data 注解，它会自动帮我们生成 getter、setter 方法，还有 equals、hashCode 等方法，让代码简洁很多。@Document 注解表示这是一个和 MongoDB 集合对应的实体类，括号里的 "users" 就是集合名，也就是说这个 User 类对应的是 MongoDB 里名为 users 的集合。@Id 注解标记的 id 字段，就是文档的唯一标识，相当于关系型数据库里的主键。

创建 UserRepository 接口

有了实体类，还得有个接口来和数据库进行交互操作。在 Spring Data MongoDB 里，我们可以通过继承 MongoRepository 来实现，代码如下：

import org.springframework.data.mongodb.repository.MongoRepository;import com.example.demo.model.User;public interface UserRepository extends MongoRepository<User, String> { // 这里可以自定义一些查询方法，比如根据用户名查询用户 User findByUsername(String username);}

这里的 UserRepository 接口继承自 MongoRepository，它的第一个泛型参数是我们前面定义的 User 实体类，第二个泛型参数是主键的类型，这里是 String。通过继承 MongoRepository，我们自动就拥有了很多常用的数据库操作方法，比如保存、删除、查询等。同时，我们还可以根据项目需求，在这个接口里自定义一些查询方法，像上面的 findByUsername 方法，就是根据用户名来查询用户。

访问 MongoDB 的两种方式

MongoRepository 方式：这种方式操作起来非常简便。比如我们要保存一个用户，代码就一行：

@Servicepublic UserService { private final UserRepository userRepository; public UserService(UserRepository userRepository) { this.userRepository = userRepository; } public User saveUser(User user) { return userRepository.save(user); }}

在这个 UserService 类里，通过构造函数注入了 UserRepository，然后调用 save 方法就能把用户保存到数据库里。查询、删除等操作也类似，都有对应的简单方法，非常适合一些简单的增删改查场景。

MongoTemplate 方式：MongoTemplate 提供了更灵活的操作方式。假设我们要进行一个复杂的查询，比如查询年龄大于某个值的用户，代码如下：

import org.springframework.beans.factory.annotation.Autowired;import org.springframework.data.mongodb.core.MongoTemplate;import org.springframework.data.mongodb.core.query.Criteria;import org.springframework.data.mongodb.core.query.Query;import org.springframework.stereotype.Service;import com.example.demo.model.User;import java.util.List;@Servicepublic UserService { @Autowired private MongoTemplate mongoTemplate; public List<User> findUsersByAgeGreaterThan(int age) { Query query = new Query(Criteria.where("age").gt(age)); return mongoTemplate.find(query, User.class); }}

这里通过 @Autowired 注解注入了 MongoTemplate，然后使用 Query 和 Criteria 来构建查询条件，这种方式能满足各种复杂的查询需求，在一些对查询灵活性要求较高的场景里非常实用。

总结

到这里，我们就详细地完成了 Spring Boot3 和 MongoDB 的整合过程。从引入依赖、配置连接，到创建实体类、接口，再到使用两种不同的方式来访问数据库，每一步都很关键。通过这种整合，我们能让项目在处理复杂数据和高并发场景时更加得心应手。