如何在Quarkus Panache MongoDB中使用无@MongoEntity注解的外部Bean？

你可以通过以下两种方案，将领域模型完全解耦于Quarkus/Panache，同时在Quarkus项目中正常使用这些模型操作MongoDB：

方案一：使用MongoDB通用注解（跨框架兼容） #

让领域类仅依赖MongoDB官方驱动的核心注解，这些注解不属于Quarkus专属，其他使用MongoDB的团队（比如用Spring Data或原生驱动）也能直接兼容。

独立领域模型代码（纯POJO+MongoDB原生注解） #

// 独立模块中的Person类，仅引入mongodb-driver-core依赖
import org.bson.types.ObjectId;
import org.bson.codecs.pojo.annotations.BsonId;
import org.bson.codecs.pojo.annotations.BsonDocument;

// 用MongoDB原生注解指定集合名
@BsonDocument(collection = "ThePerson")
public class Person {
    // 用原生注解标注主键
    @BsonId
    public ObjectId id;
    public String name;
    // 其他业务字段...
}

Quarkus项目中的使用 #

Quarkus Panache MongoDB原生支持这些MongoDB官方注解，不需要额外配置，直接像之前使用@MongoEntity一样操作即可：

import io.quarkus.mongodb.panache.PanacheMongoRepository;
import jakarta.enterprise.context.ApplicationScoped;

@ApplicationScoped
public class PersonRepository implements PanacheMongoRepository<Person> {
    // 直接使用Panache的CRUD方法，无需额外配置
}

方案二：完全无注解的纯POJO（零依赖） #

如果希望领域类完全干净，不依赖任何数据库相关注解，可以在Quarkus项目的配置文件中单独映射实体与MongoDB集合的关系。

独立领域模型代码（纯POJO） #

// 完全无依赖的纯POJO，任何Java项目都能直接复用
import org.bson.types.ObjectId;

public class Person {
    public ObjectId id;
    public String name;
    // 其他业务字段...
}

Quarkus项目中的配置 #

在application.properties中添加实体与集合的映射规则：

# 格式：quarkus.mongodb.panache.entity.<实体全类名>.collection=<集合名>
quarkus.mongodb.panache.entity.com.yourdomain.model.Person.collection=ThePerson

# 如果主键字段不是默认的"id"，还可以指定主键字段名
# quarkus.mongodb.panache.entity.com.yourdomain.model.Person.id-field=customId

Quarkus项目中的使用 #

同样直接通过Panache Repository操作即可，框架会自动读取配置完成映射：

import io.quarkus.mongodb.panache.PanacheMongoRepository;
import jakarta.enterprise.context.ApplicationScoped;

@ApplicationScoped
public class PersonRepository implements PanacheMongoRepository<Person> {
    // 正常使用Panache的CRUD方法
}

注意事项 #

• 独立的领域模型模块只需引入mongodb-driver-core基础依赖，无需任何Quarkus/Panache相关包，确保其他团队可以无缝集成。
• 若需要复杂字段映射（比如字段名别名、类型转换），可以自定义MongoDB Codec扩展，在Quarkus项目中注册即可，不影响领域模型的纯净性。

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