$binarySize（二进制大小）

最后更新：2026-10-09

$binarySize（二进制大小）

$binarySize 返回二进制数据（BinData）的字节大小；传入字符串时返回其 UTF-8 字节长度。它常用于监控附件大小、限制上传体积或做存储统计。非二进制非字符串的输入会报错。注意字符串场景与 $strLenBytes 结果一致。空二进制返回 0。它不解析内容本身，只统计存储占用的字节数，开销很低。

📝 语法

{ $binarySize: <表达式> }

⚙️ 参数

返回值：字节大小（整数）。

▶ 示例

请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：

// $binarySize：统计附件大小
 db.files.aggregate([
  { $project: { size: { $binarySize: '$data' } } }
])

运行结果：

{ "_id": 1, "size": 4096 }
{ "_id": 2, "size": 0 }

📌 注意事项

• BinData 返回字节数，字符串返回 UTF-8 字节数
• 其他类型（数字、文档）会报错
• 空二进制返回 0

🏷️ 相关标签

💡 相关案例

📚 相关教程

❓ 常见问题

Web-Tutorial 技术团队

由多位开发者共同维护的编程教程平台。每篇教程由对应领域的开发者编写和审核，确保内容准确可靠。如发现任何问题，欢迎向我们反馈。

关于我们