寻求Mongoose 6.x兼容的mongoose-xray替代方案及版本规划

1. 官方AWS X-Ray驱动集成 #

AWS官方的aws-xray-sdk-mongodb已经支持Mongoose 6.x，完全可以替代mongoose-xray：

• 安装依赖：npm install aws-xray-sdk-mongodb
• 集成代码示例：

  const AWSXRay = require('aws-xray-sdk');
  const mongoose = require('mongoose');
  
  // 包装Mongoose底层的MongoDB连接
  AWSXRay.captureMongoDB(mongoose.connection.db);
  
  // 正常初始化Mongoose连接
  await mongoose.connect('mongodb://localhost:27017/your-database');
  

  这样所有Mongoose的CRUD操作都会自动生成X-Ray子段，包含操作类型、集合名等关键信息。

2. 社区替代插件 #

目前有社区维护的适配Mongoose 6+的插件：

• mongoose-xray-v3：API和原mongoose-xray基本一致，专门适配高版本Mongoose，安装命令：npm install mongoose-xray-v3
• 手动封装钩子：如果不想依赖第三方，自己写Mongoose钩子也能实现追踪：

  const AWSXRay = require('aws-xray-sdk');
  
  // 给所有Schema添加前置钩子，创建X-Ray子段
  mongoose.Schema.pre('*', function(next) {
    const activeSegment = AWSXRay.getSegment();
    if (activeSegment) {
      this.xraySub = activeSegment.addNewSubsegment(`mongoose:${this.op}`);
      this.xraySub.addAnnotation('collection', this.collection.name);
    }
    next();
  });
  
  // 操作完成后关闭子段
  mongoose.Schema.post('*', function() {
    this.xraySub?.close();
  });
  
  // 捕获操作错误
  mongoose.Schema.post('*', function(err) {
    if (this.xraySub) {
      this.xraySub.addError(err);
      this.xraySub.close();
    }
  });
  

  这种方式可以自定义追踪的元数据，灵活度更高。

3. 原mongoose-xray的兼容情况 #

原mongoose-xray最后一次更新是2020年，目前官方没有发布适配Mongoose 6.x的计划。如果一定要用这个插件，可以去它的仓库看看有没有社区提交的兼容PR，或者自己fork仓库修改适配；更推荐直接转用上面的官方/社区替代方案。

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