$strLenBytes（字节长度）
最后更新：2026-10-09
$strLenBytes（字节长度）
$strLenBytes 返回字符串的 UTF-8 字节长度，是估算存储空间、限制字段大小的常用操作符。对纯 ASCII 文本，字节数等于字符数；中文每字 3 字节、emoji 通常 4 字节。它只接受字符串，其他类型会报错，可先 $toString 转换。与按码点计数的 $strLenCP 结果可能不同。
| 分类 | 字符串 |
|---|---|
| MongoDB 版本 | 1.0+ |
| 示例语言 | mongosh (Shell) |
📝 语法
{ $strLenBytes: <字符串表达式> }⚙️ 参数
| 字符串 | 必填，要计算长度的字符串表达式。 |
|---|
返回值：字符串的 UTF-8 字节长度整数。
▶ 示例
请在本地安装的 mongosh 中执行以下命令（需已启动 mongod）：
// $strLenBytes：统计文章标题字节数
db.articles.aggregate([
{ $project: { sizeBytes: { $strLenBytes: '$title' } } }
])运行结果：
{ "_id": 1, "sizeBytes": 42 }
{ "_id": 2, "sizeBytes": 36 }📌 注意事项
- 一个中文占 3 字节，与字符数不同
- 非字符串输入会报错，可先 $toString
- 与 $strLenCP 的结果在含多字节字符时不同
🏷️ 相关标签
💡 相关案例
更多实战案例即将上线，敬请期待。
📚 相关教程
❓ 常见问题
Q中文一个字几字节？
AUTF-8 下 3 字节。
Q和 $strLenCP 什么时候不同？
A字符串含中文或 emoji 时不同，纯 ASCII 相同。
Q能用它限制字段大小吗？
A可以，配合 $match 过滤超过字节上限的记录。
