MongoDB/Mongoose 中高效更新嵌套对象：避免整体替换的精确操作

{
  "_id": ObjectId('65b8e9f6a4e0b0c1d2e3f4g5'),
  "tenant_id": "tenant001",
  "ck_details": {
    "leadId": "L001",
    "refNum": "R001"
  }
}

TenantModel.updateOne(
  { tenant_id: 'tenant001' },
  { $set: { ck_details: { appId: 'APP_XYZ' } } }
);

{
  "_id": ObjectId('65b8e9f6a4e0b0c1d2e3f4g5'),
  "tenant_id": "tenant001",
  "ck_details": {
    "appId": "APP_XYZ" // leadId 和 refNum 被移除
  }
}

import { Schema, model, Document } from 'mongoose';

// 1. 定义嵌套对象的接口
interface CkDetails {
  leadId: string;
  refNum: string;
  appId?: string; // appId 是可选的，因为它可能在初始文档中不存在
}

// 2. 定义主文档的接口
interface ITenant extends Document {
  tenant_id: string;
  ck_details: CkDetails;
}

// 3. 定义嵌套对象的 Schema
const CkDetailsSchema = new Schema<CkDetails>({
  leadId: { type: String, required: true },
  refNum: { type: String, required: true },
  appId: { type: String, required: false } // 在 Schema 中定义 appId 字段
});

// 4. 定义主文档的 Schema
const TenantSchema = new Schema<ITenant>({
  tenant_id: { type: String, required: true, unique: true },
  ck_details: { type: CkDetailsSchema, required: true }
});

// 5. 创建 Mongoose 模型
const TenantModel = model<ITenant>('Tenant', TenantSchema);

/**
 * 更新 Tenant 文档中 ck_details 嵌套对象的 appId 字段。
 * 如果 appId 字段不存在，则添加；如果存在，则更新其值。
 *
 * @param tenantId 要更新的文档的 tenant_id
 * @param appIdValue 要设置的 appId 值
 */
async function updateTenantCkDetails(tenantId: string, appIdValue: string): Promise<void> {
  try {
    const result = await TenantModel.updateOne(
      { tenant_id: tenantId }, // 查询条件：找到匹配的 tenant_id
      { $set: { 'ck_details.appId': appIdValue } } // 更新操作：使用点表示法精确更新 appId
    );

    console.log(`更新操作结果:`, result);

    if (result.matchedCount === 0) {
      console.warn(`警告: 未找到 tenant_id 为 '${tenantId}' 的文档。`);
    } else if (result.modifiedCount === 0) {
      console.log(`信息: 文档 '${tenantId}' 的 'ck_details.appId' 字段值未发生改变 (可能已是相同值)。`);
    } else {
      console.log(`成功: 为 tenant_id 为 '${tenantId}' 的文档添加/更新了 'ck_details.appId'。`);
    }
  } catch (error) {
    console.error(`错误: 更新文档时发生异常:`, error);
  }
}

// 示例调用 (假设已经连接到 MongoDB)
// 请确保在调用此函数之前已建立 MongoDB 连接
// updateTenantCkDetails('tenant001', 'newAppIdValue123');

{
  "_id": ObjectId('65b8e9f6a4e0b0c1d2e3f4g5'),
  "tenant_id": "tenant001",
  "ck_details": {
    "leadId": "L001",
    "refNum": "R001",
    "appId": "newAppIdValue123" // 成功添加，且其他字段保持不变
  }
}