JS封装Mongoose函数时new Map报object is not iterable错误

这个问题是命名冲突+模块作用域隔离共同导致的：

1. 你原本单文件运行时，开头就写了const Map = mongoose.model(...)，这个本地定义的变量会遮蔽JS全局内置的Map构造函数，所以原来的new Map(...)能正常调用mongoose模型，完全跑通。
2. 拆分到独立文件后，Node.js采用文件级的模块作用域隔离，其他文件中定义的局部变量不会自动跨文件生效。你的generateMap所在的独立文件没有显式导入自定义的mongoose Map模型，代码里的Map不再指向你定义的数据库模型，而是直接命中了JS内置的全局Map对象。
3. JS内置Map的构造函数要求入参必须是可迭代的键值对结构，你传入的是普通JS对象{_id: 2, map: map}，不符合入参要求，因此抛出object is not iterable的类型错误。

1. 避免命名冲突，给自定义模型起专属名称 #

把原来定义的mongoose模型重命名为不会和内置对象冲突的名字，比如MapModel，从根源上避免和全局Map混淆，示例模型定义代码（可放在mapModel.js文件中）：

const mapSchema = new mongoose.Schema({ 
    _id: Number,
    map: Array
})
// 不要直接用Map作为模型变量名，避免和内置对象重名
const MapModel = mongoose.model('Map', mapSchema)
module.exports = MapModel

2. 在独立函数文件中正确导入依赖 #

在generateMap所在的独立文件里，显式导入自定义模型、mathjs库、错误处理逻辑，不要依赖全局变量的隐式查找，示例代码：

// 导入所有需要的依赖
const math = require('mathjs')
const MapModel = require('./mapModel')
const handleError = (err) => console.error('存储失败:', err)

const generateMap = function() {
    // 注意：原代码的JSON.stringify是多余操作
    // schema中map字段定义为Array类型，直接传入生成的二维数组即可
    // 之前的序列化操作反而会触发mongoose的隐式类型转换，增加不必要的性能损耗
    const mapMatrix = math.randomInt([10, 10], 2)

    // 调用导入的自定义模型创建实例
    const temp = new MapModel({ _id: 2, map: mapMatrix })
    temp.save(function (err) {
        if (err) return handleError(err);
    })
}

module.exports = generateMap

3. 在index.js中正常导入调用即可 #

只要依赖导入路径正确，之前的报错就会完全消失。

之前单文件能运行只是因为变量定义的位置恰巧遮蔽了全局的内置Map，属于巧合式的运行结果，不是稳定可靠的写法。拆分模块时一定要把所有依赖显式导入，不要依赖全局作用域的变量，同时尽量不要用JS内置对象的名称作为自定义变量名，从根源上避免这类命名冲突问题。

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