Spring Boot中如何从配置文件读取MongoDB查询语句（含投影）

你遇到的核心问题是**@Query注解的fields属性需要显式使用配置占位符（${}）来引用配置文件中的投影语句**，而非直接填写配置键名。以下是完整实现方案：

1. 配置文件中定义查询与投影语句 #

在application.properties或application.yml中添加对应配置，确保MongoDB JSON语法正确：

application.properties示例 #

# 根据名称查询的语句
GroceryItem.findItemByName={name:'?0'}
# 根据分类查询的语句
GroceryItem.findAll={category:'?0'}
# 投影配置：仅返回name和quantity字段，排除默认返回的_id
GroceryItem.findAlls={'name':1, 'quantity':1, '_id':0}

application.yml示例 #

GroceryItem:
  findItemByName: "{name:'?0'}"
  findAll: "{category:'?0'}"
  findAlls: "{'name':1, 'quantity':1, '_id':0}"

2. 修改Repository中的@Query注解 #

在fields属性中用${配置键名}的方式引用投影配置，同时建议value属性也统一使用该写法（保持规范）：

public interface ItemRepository extends MongoRepository<GroceryItem, String> {

    @Query(value = "${GroceryItem.findItemByName}")
    GroceryItem findItemByName(String name);

    // 通过${}同时绑定查询语句与投影配置
    @Query(value = "${GroceryItem.findAll}", fields = "${GroceryItem.findAlls}")
    List<GroceryItem> findAll(String category);

    public long count();
}

3. 关键注意事项 #

• JSON语法正确性：配置中的查询/投影语句必须是合法的MongoDB JSON格式。在properties文件中，若用双引号包裹整个JSON串，内部引号需转义（如"{\"name\":1}"）；用单引号包裹则无需转义。
• _id字段处理：MongoDB默认会返回_id字段，若不需要必须在投影配置中显式设置'_id':0，否则结果仍会包含该字段。
• 版本兼容性：确保使用Spring Boot 2.x及以上版本（对应的Spring Data MongoDB版本已支持占位符解析），老版本建议升级。

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