使用Mongoose存储Discord频道ID数组及追加元素的实现问题

1. 定义存储Schema和Model #

你需要先在Schema中声明数组类型字段，你的场景下存储的是字符串格式的频道ID，直接将字段类型定义为[String]即可：

const mongoose = require('mongoose');

// 对应Discord单个服务器的配置Schema
const guildConfigSchema = new mongoose.Schema({
  guildId: {
    type: String,
    required: true,
    unique: true // 每个Discord服务器仅存一条配置
  },
  // 存储允许机器人响应的频道ID数组，元素为字符串类型
  allowedChannels: [String]
});

// 导出Model供业务逻辑调用
const GuildConfig = mongoose.model('GuildConfig', guildConfigSchema);

2. 初始化数组存储 #

首次创建服务器配置时，可以直接传入数组完成初始化：

// 示例：初始化某服务器的允许响应频道列表
await GuildConfig.create({
  guildId: '替换为实际Discord服务器ID',
  allowedChannels: ['频道ID1', '频道ID2']
});

3. 向已有数组追加元素 #

Mongoose支持MongoDB原生的原子操作符，不需要手动读取数组再修改保存，避免并发冲突：

普通追加（允许重复元素） #

使用$push操作符，可追加单个或多个元素：

// 追加单个频道ID
await GuildConfig.updateOne(
  { guildId: '目标服务器ID' }, // 定位到对应服务器的配置
  { $push: { allowedChannels: '新频道ID' } }
);

// 批量追加多个频道ID
await GuildConfig.updateOne(
  { guildId: '目标服务器ID' },
  { $push: { allowedChannels: { $each: ['新频道ID1', '新频道ID2'] } } }
);

去重追加（不允许重复元素） #

你的Discord机器人场景更推荐该方式，避免重复存储同一个频道ID，使用$addToSet操作符：

// 追加单个频道ID，已存在则自动跳过
await GuildConfig.updateOne(
  { guildId: '目标服务器ID' },
  { $addToSet: { allowedChannels: '新频道ID' } }
);

// 批量去重追加多个频道ID
await GuildConfig.updateOne(
  { guildId: '目标服务器ID' },
  { $addToSet: { allowedChannels: { $each: ['新频道ID1', '新频道ID2'] } } }
);

4. 其他常用数组操作 #

读取数组 #

const config = await GuildConfig.findOne({ guildId: '目标服务器ID' });
const allowedChannels = config?.allowedChannels || [];

删除数组元素 #

使用$pull操作符移除指定元素：

await GuildConfig.updateOne(
  { guildId: '目标服务器ID' },
  { $pull: { allowedChannels: '要移除的频道ID' } }
);

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