MongoDB报Invalid BSON Field Name错误，用户积分更新操作失败如何解决

核心问题原因 #

• 你遇到的Invalid BSON field name 262014495440896000报错，根源是文档结构设计错误：你把用户的数字ID直接作为BSON文档的字段名，MongoDB解析纯数字的字段名时会误判为数组索引，触发格式校验错误。
• findOneAndUpdate使用逻辑错误：该方法的第二个参数必须包含MongoDB更新操作符（如$set/$inc），你直接传入普通键值对文档不符合语法要求。
• getMongoPoints实现不合理：每次查询都新建数据库连接性能极低，且使用distinct查询字段值的逻辑完全不符合API设计用途，容易出现空指针等异常。

修复步骤 #

1. 调整集合文档结构 #

改成标准的单用户单文档结构，示例如下：

{
  "_id": ObjectId("自动生成的ID"),
  "userId": "262014495440896000",
  "points": 100
}

2. 重写积分更新逻辑 #

直接用$inc原子操作更新积分，不需要提前查询旧值，既避免并发问题也简化代码：

// 1. 构造查询条件：匹配对应用户ID的文档
Document query = new Document("userId", user.getAsMember().getId());
// 2. 构造更新操作：给points字段加上指定数值
Document update = new Document("$inc", new Document("points", Integer.parseInt(amount.getAsString())));
// 3. 配置更新选项：如果用户不存在就新建文档（可选）
FindOneAndUpdateOptions options = new FindOneAndUpdateOptions().upsert(true);
// 执行更新
collection.findOneAndUpdate(query, update, options);

3. 重写getMongoPoints方法 #

首先建议你将MongoClient、数据库、集合实例全局复用，不要每次查询都新建连接，查询逻辑修改如下：

// 建议把这三个实例改成全局静态变量，只初始化一次
ConnectionString connectionString = new ConnectionString("你的数据库连接串");
MongoClientSettings settings = MongoClientSettings.builder()
        .applyConnectionString(connectionString)
        .build();
MongoClient mongoClient = MongoClients.create(settings);
MongoDatabase database = mongoClient.getDatabase("SRU");
MongoCollection<Document> collection = database.getCollection("points");

public static int getMongoPoints(Member m) {
    // 查询对应用户ID的文档
    Document query = new Document("userId", m.getId());
    Document result = collection.find(query).first();
    // 兼容用户不存在的情况，默认返回0积分
    if (result == null) {
        return 0;
    }
    return result.getInteger("points", 0);
}

额外优化建议 #

• 不要在每次数据库操作时新建连接，MongoClient本身是连接池实现，全局复用即可大幅提升性能。
• 原子更新操作$inc不需要提前读取当前积分值，完全避免了并发更新时的数值覆盖问题。

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