如何阻止Mongoose将字符串形式的加密地址识别为十六进制数值

0x开头的字符串会被Mongoose的默认智能类型转换逻辑识别为十六进制数值，转换后的值和数据库中存储的字符串格式地址完全不匹配，导致查询无结果，和你的推测完全一致。

• 方案1：单字段禁用自动类型转换
  在定义Schema时给地址字段添加cast: false配置，强制Mongoose不对该字段做任何类型转换，直接传入原始值匹配：

const walletSchema = new mongoose.Schema({
  address: {
    type: String,
    cast: false, // 新增配置项
    required: true,
    index: true // 建议添加索引提升查询性能
  }
  // 其余字段定义
})

注意：开启cast: false后如果传入非字符串类型的地址值，Mongoose会直接抛出类型错误，需要提前做好入参校验

• 方案2：查询时显式指定字符串匹配
  如果不想修改现有Schema定义，可以在查询时通过$expr运算符强制MongoDB按字符串类型对比：

const targetAddress = "0x754B2f9797b096f417a24686c4B368F508...";
const walletDoc = await Wallet.findOne({
  $expr: {
    $eq: ["$address", targetAddress]
  }
});

• 方案3：全局禁用十六进制自动转换
  如果项目中大量存在0x开头的字符串字段，可以直接关闭Mongoose全局的十六进制类型转换规则：

// 该配置仅支持Mongoose 6.0及以上版本
mongoose.set('castHex', false);

修改配置后可以打印Mongoose生成的实际查询过滤条件，确认地址值没有被转换：

const query = Wallet.findOne({ address: targetAddress });
console.log(query.getFilter()); 
// 正常情况应输出 { address: '0x754B2f9797b096f417a24686c4B368F508...' }，如果输出数值则说明转换仍存在

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