在MongoDB Compass Shell中使用$function运行JS函数失效/挂起求助

核心结论 #

MongoDB 6.0.6本身支持$function聚合操作，不需要额外安装驱动或包，但需要注意语法兼容性和环境配置细节。

问题分析与解决方案 #

1. 两种语法的差异 #

• 第一种语法（字符串形式函数体）是符合MongoDB官方规范的正确写法：

  db.movies.aggregate([
      { 
        $addFields: {
          fromFunction: {
            $function: {
              body: "function(){return 'hello'}",
              args: [], 
              lang: 'js'
            }
          }
         }
       }
    ])
  

  无响应可能的原因：

  • 目标集合movies为空，没有数据可返回；
  • MongoDB Compass的聚合结果显示异常，可切换到Table视图或尝试在原生mongo shell中执行该命令验证结果。

• 第二种语法直接传递函数对象：

  db.movies.aggregate([
    {
      '$addFields': {
        fromFunction: { '$function': { body: function(){return 'hello'}, args: [], lang: 'js' } }
      }
    }
  ])
  

  这种写法在MongoDB Compass中可能引发挂起，因为Compass的JavaScript执行环境与原生mongo shell存在差异，不支持直接传入函数对象，必须使用字符串形式的函数体。

2. 关于JSON.parse的挂起问题 #

如果在函数体内使用JSON.parse出现挂起，大概率是因为处理了无效的JSON字符串或null值导致报错，建议在函数中增加异常处理：

db.movies.aggregate([
    { 
      $addFields: {
        parsedJson: {
          $function: {
            body: "function(jsonStr){ try { return jsonStr ? JSON.parse(jsonStr) : null; } catch(e) { return 'invalid JSON'; } }",
            args: ["$yourJsonField"], 
            lang: 'js'
          }
        }
       }
     }
  ])

3. 确认MongoDB配置 #

检查mongod的配置文件（如mongod.conf），确保未禁用JavaScript引擎：

setParameter:
  javascriptEnabled: true

该参数默认值为true，若被手动设置为false会导致所有JavaScript相关操作失效，需修改后重启mongod服务。

验证步骤 #

1. 打开原生mongo shell，执行第一个聚合命令，确认是否返回包含fromFunction字段的结果；
2. 检查movies集合是否存在数据，可通过db.movies.countDocuments()验证；
3. 若Compass仍无显示，尝试重启Compass或切换到"Explain"视图查看聚合执行状态。

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