Ktor操作MongoDB插入文档后InsertedId返回null如何解决

insertedId返回null不是写入失败，是你当前的代码逻辑导致的：

• 你在User数据类里给@BsonId标注的_id字段设置了默认值ObjectId.get().toString()，也就是说你每次创建User实例的时候，这个主键值就已经提前生成好了，插入数据库的文档本身已经携带_id字段。
• MongoDB Kotlin驱动的逻辑是：只有当待插入文档的_id字段为null/不存在时，才会自动生成ObjectId填充，并将这个生成的ID放到插入结果的insertedId中返回。如果传入的文档已经自带_id值，插入成功后insertedId就会返回null，属于正常表现。

方案1：复用你提前生成的ID（改动最小） #

既然你创建User对象时已经生成了_id，不需要再从插入结果里取ID，直接用传入对象的_id字段即可。
修改插入方法代码：

override suspend fun insertUser(user: User): String? {
    val insertResult = users.insertOne(user)
    // 写入确认成功后直接返回对象自带的_id即可
    return if (insertResult.wasAcknowledged()) user._id else null
}

这个方案完全适配你现有String类型主键的写法，后续存会话、返回给安卓端直接用返回的ID字符串就行，findOneById传入字符串ID也能正常匹配查询。

方案2：让驱动自动生成ID，从insertedId取值 #

如果你不想提前手动生成主键，想让MongoDB驱动自动维护ID生成，就调整User类的主键定义：

@Serializable
data class User(
    @BsonId
    val _id: ObjectId? = null, // 默认为null，插入时驱动自动生成值
    val username: String,
    val password: String,
    val salt: String
)

修改后插入文档时，驱动检测到_id为null，会自动生成全局唯一的ObjectId作为主键，这时候insertedId就能正常取到值。对应的查询方法也要同步适配ObjectId类型：

override suspend fun getUser(userId: String): User? {
    // 字符串转ObjectId时加异常捕获，避免非法ID格式导致崩溃
    return runCatching { users.findOneById(ObjectId(userId)) }.getOrNull()
}

需要返回ID给安卓端时，调用_id.toString()就能转成标准的十六进制ID字符串。

• 不建议给String类型的_id写死ObjectId.get().toString()作为默认值，如果你做更新、查询操作时忘记手动传入正确的ID，会自动生成新的随机ID，导致匹配不到已有文档。
• acknowledged=true仅代表MongoDB服务端确认执行了写入操作，和insertedId是否有值没有直接关系，不能用这个字段判断ID是否生成成功。

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