Pytest中Pymongo无法查询到刚创建的MongoDB元素问题

问题分析与解决方案 #

1. 集合名称不匹配 #

检查插入接口和GET接口使用的集合名称是否一致：

• 你的GET接口查询的集合是 request.app.db["my_db"]
• 确认 given_a_new_review 调用的插入接口中，使用的集合是否也是 my_db（而非 reviews、review 这类其他名称）
• 解决：确保插入和查询操作指向同一个集合

2. _id 类型不匹配（最可能的根因） #

MongoDB对数据类型严格匹配，如果插入时_id被存为字符串，但查询时用ObjectId去匹配，会直接查不到：

• 检查插入接口代码：如果插入时手动把_id转为字符串存储（比如写了{"_id": str(ObjectId()), ...}），数据库里的_id是字符串类型，但GET接口用ObjectId(id)查询，类型不匹配导致404
• 解决方法：
  • 方案一：插入时不要手动指定_id，让MongoDB自动生成ObjectId类型的_id，此时返回的字符串_id可以通过ObjectId(id)正确匹配
  • 方案二：如果必须用字符串_id，修改GET接口的查询条件为{"_id": id}，去掉ObjectId()转换

3. 数据库实例不一致 #

确认测试代码和接口用的是同一个测试数据库：

• 测试代码中设置的数据库是self.app.db_client[self.config['TEST_DB_NAME']]
• 检查GET接口是否存在硬编码数据库名称的情况（比如误用到生产库名称）
• 解决：确保所有操作都指向TEST_DB_NAME配置的测试库

4. 测试应用实例状态污染 #

你的app是类属性，所有测试方法共享同一个实例，可能导致状态混乱：

• 把app改成实例属性，让每个测试方法用独立的应用实例：

  class TestReviewCRUD:
      def setup_method(self):
          self.app = FastAPI()
          self.config = dotenv_values("../.env")
          self.app.include_router(review_router, tags=["reviews"], prefix="/review")
          self.app.db_client = MongoClient(f'mongodb://{self.config["DB_USER"]}:{self.config["DB_PASSWORD"]}@localhost:27017/')
          self.app.db = self.app.db_client[self.config['TEST_DB_NAME']]
  

快速验证步骤 #

1. 打开MongoDB工具（比如Compass）查看插入文档的_id类型：如果是字符串，直接对应类型匹配问题；如果是ObjectId，再排查集合或数据库名称
2. 在GET接口里加调试日志，打印request.app.db.name（数据库名）、集合名和查询条件，确认是否和插入的文档信息匹配

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